home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / program / inter51b.zip / INTERRUP.E < prev    next >
Text File  |  1996-07-28  |  346KB  |  8,983 lines

  1. Interrupt List, part 5 of 15
  2. Copyright (c) 1989,1990,1991,1992,1993,1994,1995,1996 Ralf Brown
  3. --------D-213F-------------------------------
  4. INT 21 - DOS 2+ - "READ" - READ FROM FILE OR DEVICE
  5.     AH = 3Fh
  6.     BX = file handle
  7.     CX = number of bytes to read
  8.     DS:DX -> buffer for data
  9. Return: CF clear if successful
  10.         AX = number of bytes actually read (0 if at EOF before call)
  11.     CF set on error
  12.         AX = error code (05h,06h) (see #0980 at AH=59h)
  13. Notes:    data is read beginning at current file position, and the file position
  14.       is updated after a successful read
  15.     the returned AX may be smaller than the request in CX if a partial
  16.       read occurred
  17.     if reading from CON, read stops at first CR
  18.     under the FlashTek X-32 DOS extender, the pointer is in DS:EDX
  19. BUG:    Novell NETX.EXE v3.26 and 3.31 do not set CF if the read fails due to
  20.       a record lock (see AH=5Ch), though it does return AX=0005h; this
  21.       has been documented by Novell
  22. SeeAlso: AH=27h,AH=40h,AH=93h,INT 2F/AX=1108h,INT 2F/AX=1229h
  23. --------G-213F-------------------------------
  24. INT 21 - Turbo Debug HARDWARE BREAKPOINTS - READ STATUS BLOCK
  25.     AH = 3Fh
  26.     BX = handle for character device "TDHDEBUG"
  27.     CX = number of bytes to read
  28.     DS:DX -> buffer for status block (see #0718)
  29. Return: CF clear if successful
  30.         AX = number of bytes actually read
  31.     CF set on error
  32.         AX = error code (05h,06h) (see #0980 at AH=59h)
  33. SeeAlso: AH=40h"Turbo Debug"
  34.  
  35. (Table 0717)
  36. Values for status of Turbo Debugger command:
  37.  00h    successful
  38.  01h    invalid handle
  39.  02h    no more breakpoints available
  40.  03h    hardware does not support specified breakpoint type
  41.  04h    previous command prevents execution
  42.  05h    debugger hardware not found
  43.  06h    hardware failure
  44.  07h    invalid command
  45.  08h    driver not initialized yet
  46.  FEh    recursive entry (hardware breakpoint inside hw bp handler)
  47.  
  48. Format of Turbo Debugger status block:
  49. Offset    Size    Description    (Table 0718)
  50.  00h    BYTE    status of command (see #0717)
  51. ---status for command 01h---
  52.  01h    WORD    device driver interface version number (currently 1)
  53.  03h    WORD    device driver software version
  54.  05h    BYTE    maximum simultaneous hardware breakpoints
  55.  06h    BYTE    configuration bits (see #0719)
  56.  07h    BYTE    supported breakpoint types (see #0720)
  57.  08h    WORD    supported addressing match modes (see #0721)
  58.  0Ah    WORD    supported data matches (see #0722)
  59.  0Ch    BYTE    maximum data match length (01h, 02h, or 04h)
  60.  0Dh    WORD    size of onboard memory (in KB)
  61.  0Fh    WORD    maximum number of trace-back events
  62.  11h    WORD    hardware breakpoint enable byte address segment (0000h if not
  63.           supported)
  64. ---status for command 04h---
  65.  01h    BYTE    handle to use when referring to the just-set breakpoint
  66.  
  67. Bitfields for Turbo Debugger configuration bits:
  68. Bit(s)    Description    (Table 0719)
  69.  0    CPU and DMA accesses are distinct
  70.  1    can detect DMA transfers
  71.  2    supports data mask
  72.  3    hardware pass counter on breakpoints
  73.  4    can match on data as well as addresses
  74.  
  75. Bitfields for Turbo Debugger supported breakpoint types:
  76. Bit(s)    Description    (Table 0720)
  77.  0    memory read
  78.  1    memory write
  79.  2    memory read/write
  80.  3    I/O read
  81.  4    I/O write
  82.  5    I/O read/write
  83.  6    instruction fetch
  84.  
  85. Bitfields for Turbo Debugger supported addressing match modes:
  86. Bit(s)    Description    (Table 0721)
  87.  0    any address
  88.  1    equal to test value
  89.  2    not equal
  90.  3    above test value
  91.  4    below test value
  92.  5    below or equal
  93.  6    above or equal
  94.  7    within range
  95.  8    outside range
  96.  
  97. Bitfields for Turbo Debugger supported data matches:
  98. Bit(s)    Description    (Table 0722)
  99.  0    any data
  100.  1    equal to test value
  101.  2    not equal
  102.  3    above test value
  103.  4    below test value
  104.  5    below or equal
  105.  6    above or equal
  106.  7    within range
  107.  8    outside range
  108. --------N-213F-------------------------------
  109. INT 21 - PC/TCP IPCUST.SYS - READ CONFIGURATION DATA
  110.     AH = 3Fh
  111.     BX = handle for character device "$IPCUST"
  112.     CX = number of bytes to read
  113.     DS:DX -> buffer for configuration data (see #0723)
  114. Return: CF clear if successful
  115.         AX = number of bytes actually read
  116.     CF set on error
  117.         AX = error code (05h,06h) (see #0980 at AH=59h)
  118. Notes:    if less than the entire data is read or written, the next read/write
  119.       continues where the previous one ended; IOCTL calls AX=4402h and
  120.       AX=4403h both reset the location at which the next operation starts
  121.       to zero
  122.     the data pointer is also reset to zero if the previous read or write
  123.       reached or exceeded the end of the data, when the current function
  124.       is read and the previous was write, or vice versa
  125.     v2.1+ uses a new configuration method, but allows the installation
  126.       of IPCUST.SYS for backward compatibility with other software which
  127.       must read the PC/TCP configuration
  128. SeeAlso: AH=40h"IPCUST",AX=4402h"IPCUST",AX=4402h"FTPSOFT"
  129.  
  130. Format of PC/TCP configuration data:
  131. Offset    Size    Description    (Table 0723)
  132.  00h 12 BYTEs    IPCUST.SYS device driver header (see #0953)
  133.  12h    BYTE    ???
  134.  13h    BYTE    ???
  135.  14h    WORD    ???
  136.  16h    BYTE    bit flags
  137.         bit 0: send BS rather than DEL for BackSpace key
  138.         bit 1: wrap long lines
  139.  17h    BYTE    ???
  140.  18h 64 BYTEs    ASCIZ hostname
  141.  58h 64 BYTEs    ASCIZ domain name
  142.         (fully qualified domain name is hostname.domain-name)
  143.  98h 16 BYTEs    ASCIZ username
  144.  A8h 64 BYTEs    ASCIZ full name
  145.  E8h 64 BYTEs    ASCIZ office address
  146. 128h 32 BYTEs    ASCIZ phone number
  147. 148h    WORD    offset from GMT in minutes
  148. 14Ah  4 BYTEs    ASCIZ timezone name
  149. 14Eh    WORD    number of time servers
  150. 150h  ? DWORDs    (big-endian) IP addresses for time servers
  151.     ???
  152. 164h    WORD    number of old-style name servers
  153. 166h  3 DWORDs    (big-endian) IP addresses for name servers
  154. 172h    WORD    number of domain name servers
  155. 174h  3 DWORDs    (big-endian) IP addresses for domain name servers
  156. 180h    DWORD    (big-endian) IP address of default gateway
  157. 184h    DWORD    (big-endian) IP address of log server
  158. 188h    DWORD    (big-endian) IP address of cookie server
  159. 18Ch    DWORD    (big-endian) IP address of lpr server
  160. 190h    DWORD    (big-endian) IP address of imagen print server
  161. 194h 54 BYTEs    ???
  162. 1E8h    WORD    TCP default window size in bytes
  163. 1EAh    WORD    TCP low window size
  164. 1ECh 64 BYTEs    ASCIZ host tabel filename
  165. 22Ch  2 BYTEs    ???
  166. 22Eh 80 BYTEs    ASCIZ mail relay host name
  167. 27Eh    BYTE    ???
  168. 27Fh    BYTE    ??? bit flags
  169. 280h 44 BYTEs    ???
  170. 2ACh    WORD    ???
  171. 2AEh 202 BYTEs    ???
  172. --------N-213F-------------------------------
  173. INT 21 - WORKGRP.SYS - GET ENTRY POINT
  174.     AH = 3Fh
  175.     BX = file handle for device "NET$HLP$"
  176.     CX = 0008h
  177.     DS:DX -> buffer for entry point record (see #0793)
  178. Return: CF clear if successful
  179.         AX = number of bytes actually read (0 if at EOF before call)
  180.     CF set on error
  181.         AX = error code (05h,06h) (see #0980 at AH=59h)
  182. Program: WORKGRP.SYS is the portion of Microsoft's Workgroup Connection which
  183.       permits communication with PCs running Windows for Workgroups or
  184.       LAN Manager
  185. SeeAlso: AX=4402h"WORKGRP.SYS",INT 2F/AX=9400h
  186. --------N-213F-------------------------------
  187. INT 21 - BW-TCP - GET DRIVER INFO
  188.     AH = 3Fh
  189.     BX = file handle for device "ETHDEV27"
  190.     CX = 002Bh
  191.     DS:DX -> buffer for driver info (see #0724)
  192. Return: CF clear if successful
  193.         AX = number of bytes actually read (0 if at EOF before call)
  194.     CF set on error
  195.         AX = error code (05h,06h) (see #0980 at AH=59h)
  196. Program: BW-TCP is a TCP/IP protocol stack by Beame & Whiteside Software
  197. Notes:    the B&W socket library performs an INT 21/AX=4401h with DX=0060h before
  198.       making this call to retrieve the driver information; one should also
  199.       call the private API interrupt with AH=15h
  200.     the installation check for the TCP/IP stack is to test for the
  201.       existence of the character device UDP-IP10
  202. SeeAlso: INT 14/AH=56h,INT 62/AH=00h"ETHDEV",INT 63/AH=03h,INT 64/AH=00h
  203. Index:    installation check;BW-TCP hardware driver
  204. Index:    installation check;BW-TCP TCPIP.SYS
  205.  
  206. Format of BW-TCP driver info:
  207. Offset    Size    Description    (Table 0724)
  208.  00h    WORD    I/O base address
  209.  02h    BYTE    shared memory page (01h = segment 0100h, etc.)
  210.  03h    BYTE    interrupt vector for private API
  211.  04h    BYTE    IRQ used by board
  212.  05h    WORD    size of data buffer
  213.  07h    WORD    maximum transfer window
  214.  09h    WORD    time zone
  215.  0Bh    BYTE    address type (01h user, 04h RARP, 05h BOOTP)
  216.  0Ch    DWORD    internet address
  217.  10h    WORD    "value" ???
  218.  12h    BYTE    subnet mask
  219.  13h    WORD    "ether_pointer" ???
  220.  15h    WORD    offset in device driver of log server records (see #0725)
  221.  17h    WORD    offset in device driver of name server records (see #0725)
  222.  19h    WORD    offset in device driver of print server records (see #0725)
  223.  1Bh    WORD    offset in device driver of time server records (see #0725)
  224.  1Dh    WORD    offset in device driver of gateway records (see #0725)
  225.  1Fh    WORD    segment address of device driver
  226.  21h    BYTE    transfer size
  227.  22h  9 BYTEs    network adapter board name
  228. ---11/21/91+ ---
  229.  23h    BYTE    ETHDEV version (major in high nybble, minor in low nybble)
  230.  24h    BYTE    ETHDEV revision
  231.  25h    BYTE    TCPIP version (major in high nybble, minor in low nybble)
  232.  26h    BYTE    TCPIP revision
  233.  27h    BYTE    BWRPC version (major in high nybble, minor in low nybble)
  234.  28h    BYTE    BWRPC revision
  235.  29h    BYTE    BWNFS version (major in high nybble, minor in low nybble)
  236.  2Ah    BYTE    BWNFS revision
  237.  2Bh    BYTE    Telnet version (major in high nybble, minor in low nybble)
  238.  2Ch    BYTE    Telnet revision
  239.  2Dh    BYTE    NETBIOS version (major in high nybble, minor in low nybble)
  240.  2Eh    BYTE    NETBIOS revision
  241. Note:    for each driver, if version=0, the driver is not installed or does
  242.       not support the version check
  243.  
  244. Format of BW-TCP server records:
  245. Offset    Size    Description    (Table 0725)
  246.  00h    BYTE    number of server records following
  247.  01h  N DWORDs    internet addresses of servers
  248. --------y-213F-------------------------------
  249. INT 21 - Trusted Access - NB.SYS - GET STATE
  250.     AH = 3Fh
  251.     BX = file handle for device "$$NB$$NB"
  252.     CX = 0002h (size of state)
  253.     DS:DX -> buffer for state record (see #0726)
  254. Return: CF clear if successful
  255.         AX = number of bytes actually read (0 if at EOF before call)
  256.     CF set on error
  257.         AX = error code (05h,06h) (see #0980 at AH=59h)
  258. Program: Trusted Access is a security and access-control package by Lassen
  259.       Software, Inc.; NB.SYS is a device driver to prevent the user from
  260.       terminating CONFIG.SYS or AUTOEXEC.BAT with Ctrl-Break
  261. SeeAlso: AH=40h"NB.SYS",AX=4101h
  262.  
  263. Format of Trusted Access state record:
  264. Offset    Size    Description    (Table 0726)
  265.  00h    BYTE    00h off, 01h on
  266.  01h    BYTE    keys being disabled
  267.         bit 0: Ctrl-Break
  268.         bit 1: SysReq
  269.         bit 2: Ctrl and Alt
  270.         bit 3: Ctrl-Alt-Del
  271.         bit 7: all keys (overrides other bits)
  272. ----------213F-------------------------------
  273. INT 21 U - IFSHLP.SYS - GET ENTRY POINT
  274.     AH = 3Fh
  275.     BX = file handle for device "IFS$HLP$"
  276.     CX = 0008h (size of buffer in bytes)
  277.     DS:DX -> buffer for entry point record (see #0727)
  278. Return: CF clear if successful
  279.         AX = number of bytes actually read (0 if at EOF before call)
  280.     CF set on error
  281.         AX = error code (05h,06h) (see #0980 at AH=59h)
  282. Program: IFSHLP.SYS is a support driver for Microsoft Windows for Workgroups
  283. SeeAlso: AX=4402h"IFSHLP"
  284.  
  285. Format of IFSHLP.SYS entry point record:
  286. Offset    Size    Description    (Table 0727)
  287.  00h  4 BYTEs    (call) signature 70h E9h 34h 37h
  288.         signature must be 34h 37h 70h EFh if called via IOCTL
  289.  04h    DWORD    (ret) pointer to FAR call entry point (see #0728)
  290.  
  291. (Table 0728)
  292. Call IFSHLP.SYS entry point with:
  293.     STACK:    WORD    function number (00h-0Ch)
  294.             00h ???
  295.             01h set ??? intercept
  296.             02h remove ??? intercept
  297.             03h ??? LPT2
  298.             04h ??? LPT1
  299.             05h ??? and remove ??? intercept
  300.             06h set ??? flag
  301.             07h clear ??? flag
  302.             08h get ??? flag word
  303.             09h ???
  304.             0Ah ???
  305.             0Bh ???
  306.             0Ch get ???
  307. ---if function 00h---
  308. Return: AX = ??? (0024h seen)
  309.     DX = resident code segment
  310. ---if function 01h---
  311.     STACK:    DWORD    new intercept address
  312. Return: AX = status
  313.         0000h successful
  314.         0001h failed (already set)
  315.         DX = 0000h
  316. ---if function 02h---
  317. Return: AX = status
  318.         0000h successful
  319.         0001h failed (not set)
  320.     DX = 0000h
  321. ---if function 03h,04h---
  322.     STACK:    WORD    ???
  323. Return: AX = 0000h
  324.     DX = 0000h
  325. ---if function 05h---
  326.     ???
  327. ---if function 06h---
  328. Return: AX = 0001h and DX = 0000h if already set
  329.     AX,DX unchanged if successful
  330. ---if function 07h---
  331. Return: AX = 0001h and DX = 0000h if not set
  332.     AX,DX unchanged if successful
  333. ---if function 08h---
  334. Return: DX = 0000h
  335.     AX = flags (bit 0 set/cleared by functions 06h and 07h)
  336. ---if function 09h---
  337. Return: AX = status
  338.         0000h successful
  339.         0001h failed (already called)
  340. ---if function 0Ah---
  341.     STACK:    WORD    ???
  342.     ???
  343. ---if function 0Bh---
  344. Return: AX = status
  345.         0000h successful
  346.         0001h failed (not set)
  347. ---if function 0Ch---
  348. Return: AX = 0000h
  349.     ES:BX -> ??? data
  350. ---if function > 0Ch---
  351. Return:    AX = 0001h
  352.     DX = 0000h
  353. --------v-213F--BXFEB0-----------------------
  354. INT 21 - VIRUS - "KYZ/LieWait" - INSTALLATION CHECK
  355.     AH = 3Fh
  356.     BX = FEB0h
  357. Return: BX = 1212h if resident
  358. SeeAlso: AX=3032h"VIRUS",AX=4BF1h"VIRUS"
  359. --------D-2140-------------------------------
  360. INT 21 - DOS 2+ - "WRITE" - WRITE TO FILE OR DEVICE
  361.     AH = 40h
  362.     BX = file handle
  363.     CX = number of bytes to write
  364.     DS:DX -> data to write
  365. Return: CF clear if successful
  366.         AX = number of bytes actually written
  367.     CF set on error
  368.         AX = error code (05h,06h) (see #0980 at AH=59h)
  369. Notes:    if CX is zero, no data is written, and the file is truncated or
  370.       extended to the current position
  371.     data is written beginning at the current file position, and the file
  372.       position is updated after a successful write
  373.     the usual cause for AX < CX on return is a full disk
  374. BUG:    a write of zero bytes will appear to succeed when it actually failed
  375.       if the write is extending the file and there is not enough disk
  376.       space for the expanded file (DOS 5.0-6.0); one should therefore check
  377.       whether the file was in fact extended by seeking to 0 bytes from
  378.       the end of the file (INT 21/AX=4202h/CX=0/DX=0)
  379.     under the FlashTek X-32 DOS extender, the pointer is in DS:EDX
  380. SeeAlso: AH=28h,AH=3Fh,AH=93h,INT 2F/AX=1109h
  381. --------G-2140-------------------------------
  382. INT 21 - Turbo Debug HARDWARE BREAKPOINTS - SEND CMD TO HARDWARE BRKPNT DRIVER
  383.     AH = 40h
  384.     BX = handle for character device "TDHDEBUG"
  385.     CX = number of bytes to write
  386.     DS:DX -> hardware breakpoint command (see #0729)
  387. Return: CF clear if successful
  388.         AX = number of bytes actually written
  389.     CF set on error
  390.         AX = error code (05h,06h) (see #0980 at AH=59h)
  391. Note:    results are retrieved by reading from the device
  392. SeeAlso: AH=3Fh"Turbo Debug"
  393.  
  394. Format of Turbo Debugger hardware breakpoint commands:
  395. Offset    Size    Description    (Table 0729)
  396.  00h    BYTE    command code
  397.         00h install interrupt vectors
  398.         01h get hardware capabilities
  399.         02h enable hardware breakpoints
  400.         03h disable hardware breakpoints
  401.         04h set hardware breakpoint
  402.         05h clear hardware breakpoint
  403.         06h set I/O base address and reset hardware
  404.         07h restore interrupt vectors
  405. ---command code 00h---
  406.  01h    DWORD    pointer to Turbo Debugger entry point to be jumped to on
  407.           hardware breakpoint; call with CPU state the same as on
  408.           the breakpoint except for pushing AX and placing an entry
  409.           code (FFh if breakout button or breakpoint handle) in AH
  410. ---command code 04h---
  411.  01h    BYTE    breakpoint type
  412.         00h memory read
  413.         01h memory write
  414.         02h memory read/write
  415.         03h I/O read
  416.         04h I/O write
  417.         05h I/O read/write
  418.         06h instruction fetch
  419.  02h    BYTE    address matching mode (see #0730)
  420.  03h    DWORD    32-bit linear low address
  421.  07h    DWORD    32-bit linear high address
  422.  0Bh    WORD    pass count
  423.  0Dh    BYTE    data size (01h, 02h, or 04h)
  424.  0Eh    BYTE    source of matched bus cycle (01h CPU, 02h DMA, 03h either)
  425.  0Fh    BYTE    data-matching mode (see #0730)
  426.  10h    DWORD    low data value
  427.  14h    DWORD    high data value
  428.  18h    DWORD    data mask specifying which bits of the data are tested
  429. ---command code 05h---
  430.  01h    BYTE    handle of breakpoint to clear (breakpoint returned from command
  431.           04h)
  432. ---command code 06h---
  433.  01h    WORD    base address of hardware debugger board
  434.  
  435. (Table 0730)
  436. Values for Turbo Debugger address/data matching mode:
  437.  00h    match any
  438.  01h    equal to test value
  439.  02h    different from test value
  440.  03h    above test value
  441.  04h    below test value
  442.  05h    below or equal to test value
  443.  06h    above or equal to test value
  444.  07h    within inclusive range
  445.  08h    outside specified range
  446. --------N-2140-------------------------------
  447. INT 21 - PC/TCP IPCUST.SYS - WRITE CONFIGURATION DATA
  448.     AH = 40h
  449.     BX = handle for character device "$IPCUST"
  450.     CX = number of bytes to write
  451.     DS:DX -> buffer for configuration data (AH=3Fh"IPCUST")
  452. Return: CF clear if successful
  453.         AX = number of bytes actually written
  454.     CF set on error
  455.         AX = error code (05h,06h) (see #0980 at AH=59h)
  456. Notes:    if less than the entire data is read or written, the next read/write
  457.       continues where the previous one ended; IOCTL calls AX=4402h and
  458.       AX=4403h both reset the location at which the next operation starts
  459.       to zero
  460.     the data pointer is also reset to zero if the previous read or write
  461.       reached or exceeded the end of the data, when the current function
  462.       is read and the previous was write, or vice versa
  463.     v2.1+ uses a new configuration method, but allows the installation
  464.       of IPCUST.SYS for backward compatibility with other software which
  465.       must read the PC/TCP configuration
  466. SeeAlso: AH=3Fh"IPCUST",AX=4402h"IPCUST"
  467. --------y-2140-------------------------------
  468. INT 21 U - Trusted Access - NB.SYS - SET STATE
  469.     AH = 40h
  470.     BX = handle for character device "$$NB$$NB"
  471.     DS:DX -> state record (see #0726)
  472.     CX ignored
  473. Return: CF clear if successful
  474.         AX = number of bytes actually written
  475.     CF set on error
  476.         AX = error code (05h,06h) (see #0980 at AH=59h)
  477. Program: Trusted Access is a security and access-control package by Lassen
  478.       Software, Inc.; NB.SYS is a device driver to prevent the user from
  479.       terminating CONFIG.SYS or AUTOEXEC.BAT with Ctrl-Break
  480. SeeAlso: AH=3Fh"NB.SYS"
  481. --------j-214000BX0002-----------------------
  482. INT 21 - FARTBELL.EXE - INSTALLATION CHECK
  483.     AX = 4000h
  484.     BX = 0002h
  485.     CX = 0000h
  486.     DS:DX = 0000h:0000h
  487. Return: CF clear if installed
  488.         AX = CS of resident code
  489. Program: FARTBELL is a joke program by Guenther Thiele which makes various
  490.       noises when programs output a bell
  491. SeeAlso: AX=4001h
  492. --------j-214001BX0002-----------------------
  493. INT 21 - FARTBELL.EXE - FORCE NOISE
  494.     AX = 4001h
  495.     BX = 0002h
  496.     CX = 0000h
  497.     DS:DX = 0000h:0000h
  498. Program: FARTBELL is a joke program by Guenther Thiele which makes various
  499.       noises when programs output a bell
  500. SeeAlso: AX=4000h
  501. --------D-2141-------------------------------
  502. INT 21 - DOS 2+ - "UNLINK" - DELETE FILE
  503.     AH = 41h
  504.     DS:DX -> ASCIZ filename (no wildcards, but see notes)
  505.     CL = attribute mask for deletion (server call only, see notes)
  506. Return: CF clear if successful
  507.         AX destroyed (DOS 3.3) AL seems to be drive of deleted file
  508.     CF set on error
  509.         AX = error code (02h,03h,05h) (see #0980 at AH=59h)
  510. Notes:    (DOS 3.1+) wildcards are allowed if invoked via AX=5D00h, in which case
  511.       the filespec must be canonical (as returned by AH=60h), and only
  512.       files matching the attribute mask in CL are deleted
  513.     DR DOS 5.0-6.0 returns error code 03h if invoked via AX=5D00h; DR DOS
  514.       3.41 crashes if called via AX=5D00h with wildcards
  515.     DOS does not erase the file's data; it merely becomes inaccessible
  516.       because the FAT chain for the file is cleared
  517.     deleting a file which is currently open may lead to filesystem
  518.       corruption.  Unless SHARE is loaded, DOS does not close the handles
  519.       referencing the deleted file, thus allowing writes to a nonexistant
  520.       file.
  521.     under DR DOS and DR Multiuser DOS, this function will fail if the file
  522.       is currently open
  523.     under the FlashTek X-32 DOS extender, the pointer is in DS:EDX
  524. BUG:    DR DOS 3.41 crashes if called via AX=5D00h
  525. SeeAlso: AH=13h,AX=4301h,AX=4380h,AX=5D00h,AH=60h,AH=71h,AX=F244h
  526. SeeAlso: INT 2F/AX=1113h
  527. --------y-214101DXFFFE-----------------------
  528. INT 21 - SoftLogic Data Guardian - ???
  529.     AX = 4101h
  530.     DX = FFFEh
  531. Return: AX = 0000h if installed
  532. Note:    resident code sets several internal variables on this call
  533. SeeAlso: AH=3Fh"NB.SYS",INT 16/AX=FFA3h/BX=0000h
  534. --------D-2142-------------------------------
  535. INT 21 - DOS 2+ - "LSEEK" - SET CURRENT FILE POSITION
  536.     AH = 42h
  537.     AL = origin of move
  538.         00h start of file
  539.         01h current file position
  540.         02h end of file
  541.     BX = file handle
  542.     CX:DX = offset from origin of new file position
  543. Return: CF clear if successful
  544.         DX:AX = new file position in bytes from start of file
  545.     CF set on error
  546.         AX = error code (01h,06h) (see #0980 at AH=59h)
  547. Notes:    for origins 01h and 02h, the pointer may be positioned before the
  548.       start of the file; no error is returned in that case, but subsequent
  549.       attempts at I/O will produce errors
  550.     if the new position is beyond the current end of file, the file will
  551.       be extended by the next write (see AH=40h)
  552. BUG:    using this method to grow a file from zero bytes to a very large size
  553.       can corrupt the FAT in some versions of DOS; the file should first
  554.       be grown from zero to one byte and then to the desired large size
  555. SeeAlso: AH=24h,INT 2F/AX=1228h
  556. --------v-214203-----------------------------
  557. INT 21 - VIRUS - "Shake" - INSTALLATION CHECK
  558.     AX = 4203h
  559. Return: AX = 1234h if resident
  560. SeeAlso: AX=3DFFh,AX=4243h
  561. --------v-214243-----------------------------
  562. INT 21 - VIRUS - "Invader" - INSTALLATION CHECK
  563.     AX = 4243h
  564. Return: AX = 5678h if resident
  565. SeeAlso: AX=4203h,AX=44A0h,AX=4B04h
  566. --------D-214300-----------------------------
  567. INT 21 - DOS 2+ - GET FILE ATTRIBUTES
  568.     AX = 4300h
  569.     DS:DX -> ASCIZ filename
  570. Return: CF clear if successful
  571.         CX = file attributes (see #0731)
  572.         AX = CX (DR DOS 5.0)
  573.     CF set on error
  574.         AX = error code (01h,02h,03h,05h) (see #0980 at AH=59h)
  575. Notes:    under the FlashTek X-32 DOS extender, the filename pointer is in DS:EDX
  576.     under DR DOS 3.41 and 5.0, attempts to change the subdirectory bit are
  577.       simply ignored without an error
  578. BUG:    Windows for Workgroups returns error code 05h (access denied) instead
  579.       of error code 02h (file not found) when attempting to get the
  580.       attributes of a nonexistent file.  This causes open() with O_CREAT
  581.       and fopen() with the "w" mode to fail in Borland C++.
  582. SeeAlso: AX=4301h,AX=4310h,AX=7143h,AH=B6h,INT 2F/AX=110Fh,INT 60/DI=0517h
  583. --------D-214301-----------------------------
  584. INT 21 - DOS 2+ - "CHMOD" - SET FILE ATTRIBUTES
  585.     AX = 4301h
  586.     CX = new file attributes (see #0731)
  587.     DS:DX -> ASCIZ filename
  588. Return: CF clear if successful
  589.         AX destroyed
  590.     CF set on error
  591.         AX = error code (01h,02h,03h,05h) (see #0980 at AH=59h)
  592. Notes:    will not change volume label or directory attribute bits, but will
  593.       change the other attribute bits of a directory (the directory
  594.       bit must be cleared to successfully change the other attributes of a
  595.       directory, but the directory will not be changed to a normal file as
  596.       a result)
  597.     MS-DOS 4.01 reportedly closes the file if it is currently open
  598.     for security reasons, the Novell NetWare execute-only bit can never
  599.       be cleared; the file must be deleted and recreated
  600.     under the FlashTek X-32 DOS extender, the filename pointer is in DS:EDX
  601.     DOS 5.0 SHARE will close the file if it is currently open in sharing-
  602.       compatibility mode, otherwise a sharing violation critical error is
  603.       generated if the file is currently open
  604.     DR DOS 3.41/5.0 will silently ignore attempts to change the 'directory'
  605.       attribute bit
  606. SeeAlso: AX=4300h,AX=4311h,AX=7143h,INT 2F/AX=110Eh
  607.  
  608. Bitfields for file attributes:
  609. Bit(s)    Description    (Table 0731)
  610.  7    shareable (Novell NetWare)
  611.  6    unused
  612.  5    archive
  613.  4    directory
  614.  3    volume label
  615.     execute-only (Novell NetWare)
  616.  2    system
  617.  1    hidden
  618.  0    read-only
  619. --------D-214302-----------------------------
  620. INT 21 - DOS 7 - GET COMPRESSED FILE SIZE
  621.     AX = 4302h
  622.     DS:DX -> ASCIZ pathname for file or directory
  623. Return: CF clear if successful
  624.         ??? = compressed size of file/directory in bytes
  625.     CF set on error
  626.         AX = error code
  627. Note:    on volumes which do not support compression, the returned size is the
  628.       actual file size rounded up to the next cluster boundary
  629. SeeAlso: AH=71h,AH=72h
  630. --------O-214302-----------------------------
  631. INT 21 - DR DOS 3.41+ internal - GET ACCESS RIGHTS
  632.     AX = 4302h
  633.     DS:DX -> ASCIZ pathname
  634. Return: CF clear if successful
  635.         CX = access rights (see #0732)
  636.         AX = CX (DR DOS 5.0)
  637.     CF set on error
  638.         AX = error code
  639. Desc:    Determine which operations the calling program may perform on a
  640.       specified file without being required to provide a password.
  641. Notes:    this protection scheme has been coordinated on all current Digital
  642.       Research/Novell operating systems (DR DOS 3.41+, DRMDOS 5.x, and
  643.       FlexOS 2+)
  644.     this function is documented in DR DOS 6.0 and corresponds to the
  645.       "Get/Set File Attributes" function, subfunction 2, documented in
  646.       Concurrent DOS.
  647.     only FlexOS actually uses the "execution" bits; DR DOS 3.41+ treats
  648.       them as "read" bits.
  649.     DR DOS 3.41-5.x only use bits 0-3.  Only DR DOS 6.0 using a
  650.       DRMDOS 5.x security system allowing for users and groups uses bits
  651.       4-11.
  652. SeeAlso: AX=4303h
  653.  
  654. Bitfields for DR DOS file access rights:
  655. Bit(s)    Description    (Table 0732)
  656.  0    owner delete requires password
  657.  1    owner execution requires password (FlexOS)
  658.  2    owner write requires password
  659.  3    owner read requires password
  660.  4    group delete requires password
  661.  5    group execution requires password (FlexOS)
  662.  6    group write requires password
  663.  7    group read requires password
  664.  8    world delete requires password
  665.  9    world execution requires password (FlexOS)
  666.  10    world write requires password
  667.  11    world read requires password
  668. --------O-214303-----------------------------
  669. INT 21 - DR DOS 3.41+ internal - SET ACCESS RIGHTS AND PASSWORD
  670.     AX = 4303h
  671.     CX = access rights
  672.          bits 11-0: access rights (see #0732)
  673.          bit 15: new password is to be set
  674.     DS:DX -> ASCIZ pathname
  675.     [DTA] = new password if CX bit 15 is set (blank-padded to 8 characters)
  676. Return: CF clear if successful
  677.     CF set on error
  678.         AX = error code
  679. Notes:    if the file is already protected, the old password must be added after
  680.       the pathname, separated by a ";"
  681.     this function is documented in DR DOS 6.0 and corresponds to the
  682.       "Get/Set File Attributes" function, subfunction 3, documented in
  683.       Concurrent DOS.
  684. SeeAlso: AH=0Fh,AH=17h,AX=4302h"DR DOS",AX=4305h,AX=4454h
  685. --------O-214304-----------------------------
  686. INT 21 U - DR DOS 5.0-6.0 internal - GET ENCRYPTED PASSWORD
  687.     AX = 4304h
  688.     DS:DX -> ASCIZ filename
  689.     ???
  690. Return: CF clear if successful
  691.         CX = AX = 0000h if no password assigned to file
  692.     CF set on error
  693.         AX = error code (see #0980 at AH=59h)
  694. Note:    this function is only supported by DR DOS 5.0 and 6.0 and DRMDOS 5.1
  695. SeeAlso: AX=4303h,AX=4305h
  696. --------O-214305-----------------------------
  697. INT 21 U - DR DOS 5.0-6.0 internal - SET EXTENDED FILE ATTRIBUTES
  698.     AX = 4305h
  699.     DS:DX -> ASCIZ filename
  700.     ???
  701. Return: CF clear if successful
  702.     CF set on error
  703.         AX = error code (see #0980 at AH=59h)
  704. Desc:    this function allows the extended attributes, and optionally the
  705.       encrypted password, of a file to be set.
  706. Note:    this function is only supported by DR DOS 5.0 and 6.0 and DRMDOS 5.1
  707. SeeAlso: AX=4304h,AX=4311h
  708. --------O-214306-----------------------------
  709. INT 21 - DR DOS 6.0 - GET FILE OWNER
  710.     AX = 4306h
  711.     DS:DX -> ASCIZ filename
  712. Return: CF clear if successful
  713.         AX = CX = value set with AX=4307h
  714.     CF set on error
  715.         AX = error code (see #0980 at AH=59h)
  716. SeeAlso: AX=4307h
  717. --------O-214307-----------------------------
  718. INT 21 - DR DOS 6.0 - SET FILE OWNER
  719.     AX = 4307h
  720.     CX = ??? (owner identification number?)
  721.     DS:DX -> ASCIZ filename
  722. Return: CF clear if successful
  723.     CF set on error
  724.         AX = error code (see #0980 at AH=59h)
  725. SeeAlso: AX=4306h
  726. --------N-214310-----------------------------
  727. INT 21 - Banyan VINES 2.1+ - GET EXTENDED FILE ATTRIBUTES
  728.     AX = 4310h
  729.     DS:DX -> ASCIZ filename
  730. Return: CF clear if successful
  731.         CH = attributes (see #0733)
  732.     CF set on error
  733.         AX = error code (01h,02h,03h,05h) (see #0980 at AH=59h)
  734. Note:    the filename may be a directory but must be on a VINES file service
  735. SeeAlso: AX=4300h,AX=4311h,AH=B6h,INT 2F/AX=110Fh
  736. --------N-214311-----------------------------
  737. INT 21 - Banyan VINES 2.1+ - SET EXTENDED FILE ATTRIBUTES
  738.     AX = 4311h
  739.     CH = new attributes (see #0733)
  740.     DS:DX -> ASCIZ filename
  741. Return: CF clear if successful
  742.     CF set on error
  743.         AX = error code (01h,02h,03h,05h) (see #0980 at AH=59h)
  744. Note:    the filename may be a directory but must be on a VINES file service
  745. SeeAlso: AX=4301h,AX=4305h,AX=4310h,INT 2F/AX=110Eh
  746.  
  747. Bitfields for VINES extended file attributes:
  748. Bit(s)    Description    (Table 0733)
  749.  7    unused
  750.  6    shareable
  751.  5    execute-only
  752.  4-0    unused
  753. --------u-214321BX0000-----------------------
  754. INT 21 - Q87, Q387 - INSTALLATION CHECK
  755.     AX = 4321h
  756.     BX = 0000h
  757.     EAX = 87654321h (entire EAX value is required, not just AX)
  758. Return: EAX = 12345678h if installed
  759. Program: Q387 (renamed to Q87 as of v3.7) is a math coprocessor emulator from
  760.       Quickware
  761. Note:    this function is available only in virtual-86 mode in older versions;
  762.       newer versions also provide it in MS Windows 16- and 32-bit protected
  763.       mode
  764. SeeAlso: AX=4321h/BX=0001h,AX=4321h/BX=0002h,INT 67/AX=4321h
  765. --------u-214321BX0001-----------------------
  766. INT 21 - Q87, Q387 - ENABLE EMULATOR
  767.     AX = 4321h
  768.     BX = 0001h
  769.     EAX = 87654321h (entire EAX value is required, not just AX)
  770. Desc:    enable the emulator by setting the CPU MSW's EM bit and updating
  771.       the BIOS equipment list
  772. Note:    this function is available only in virtual-86 mode in older versions;
  773.       newer versions also provide it in MS Windows 16- and 32-bit protected
  774.       mode
  775. SeeAlso: AX=4321h/BX=0000h,AX=4321h/BX=0002h
  776. --------u-214321BX0002-----------------------
  777. INT 21 - Q87, Q387 - DISABLE EMULATOR
  778.     AX = 4321h
  779.     BX = 0002h
  780.     EAX = 87654321h (entire EAX value is required, not just AX)
  781. Desc:    disable the emulator by clearing the CPU MSW's EM bit and updating
  782.       the BIOS equipment list
  783. Note:    this function is available only in virtual-86 mode in older versions;
  784.       newer versions also provide it in MS Windows 16- and 32-bit protected
  785.       mode
  786. SeeAlso: AX=4321h/BX=0000h,AX=4321h/BX=0001h
  787. --------O-214380-----------------------------
  788. INT 21 - Novell DOS 7 - UNDELETE PENDING DELETE FILE
  789.     AX = 4380h
  790.     ???
  791. Return: ???
  792. SeeAlso: AH=41h,AX=4381h
  793. --------O-214381-----------------------------
  794. INT 21 - Novell DOS 7 - PURGE PENDING DELETE FILE
  795.     AX = 4381h
  796.     ???
  797. Return: ???
  798. SeeAlso: AH=41h,AX=4380h
  799. --------D-214400-----------------------------
  800. INT 21 - DOS 2+ - IOCTL - GET DEVICE INFORMATION
  801.     AX = 4400h
  802.     BX = handle
  803. Return: CF clear if successful
  804.         DX = device information word (see #0734)
  805.         AX destroyed
  806.     CF set on error
  807.         AX = error code (01h,05h,06h) (see #0980 at AH=59h)
  808. Notes:    value in DH corresponds to high byte of device driver's attribute word
  809.       if handle refers to a character device
  810.     Novell NetWare reportedly does not return a drive number in bits 5-0
  811.       for a disk file
  812. SeeAlso: AX=4401h,INT 2F/AX=122Bh
  813.  
  814. Bitfields for device information word:
  815. Bit(s)    Description    (Table 0734)
  816.  character device
  817.   14    device driver can process IOCTL requests (see AX=4402h)
  818.   13    output until busy supported
  819.   11    driver supports OPEN/CLOSE calls
  820.    7    set (indicates device)
  821.    6    EOF on input
  822.    5    raw (binary) mode
  823.    4    device is special (uses INT 29)
  824.    3    clock device
  825.    2    NUL device
  826.    1    standard output
  827.    0    standard input
  828.  disk file
  829.   15    file is remote (DOS 3.0+)
  830.   14    don't set file date/time on closing (DOS 3.0+)
  831.   11    media not removable
  832.    8    (DOS 4 only) generate INT 24 if no disk space on write or read past
  833.       end of file
  834.    7    clear (indicates file)
  835.    6    file has not been written
  836.   5-0    drive number (0 = A:)
  837. --------D-214401-----------------------------
  838. INT 21 - DOS 2+ - IOCTL - SET DEVICE INFORMATION
  839.     AX = 4401h
  840.     BX = handle (must refer to character device)
  841.     DX = device information word (see #0734)
  842.         (DH must be zero)
  843. Return: CF clear if successful
  844.     CF set on error
  845.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  846. SeeAlso: AX=4400h,INT 2F/AX=122Bh
  847. --------D-214402-----------------------------
  848. INT 21 - DOS 2+ - IOCTL - READ FROM CHARACTER DEVICE CONTROL CHANNEL
  849.     AX = 4402h
  850.     BX = file handle referencing character device
  851.     CX = number of bytes to read
  852.     DS:DX -> buffer
  853. Return: CF clear if successful
  854.         AX = number of bytes actually read
  855.     CF set on error
  856.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  857. Note:    format of data is driver-specific (see below for some specific cases)
  858. SeeAlso: AX=4400h,AX=4403h,AX=4404h,INT 2F/AX=122Bh
  859. --------N-214402-----------------------------
  860. INT 21 - Network Driver Interface Specification (NDIS) 2.0.1 - PROTOCOL MANAGER
  861.     AX = 4402h
  862.     BX = file handle for device "PROTMAN$"
  863.     CX = 000Eh (size of request block)
  864.     DS:DX -> request block (see #0735,#0736,#0737,#0738,#0739,#0743,#0744)
  865. Return: CF clear if successful
  866.         AX = number of bytes actually read
  867.     CF set on error
  868.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  869. SeeAlso: AX=4402h"FTPSOFT"
  870.  
  871. Format of NDIS request block for GetProtocolManagerInfo:
  872. Offset    Size    Description    (Table 0735)
  873.  00h    WORD    01h
  874.  02h    WORD    returned status (see #0745)
  875.  04h    DWORD    returned pointer to structure representing parsed user config
  876.  08h    DWORD    unused
  877.  0Ch    WORD    returned BCD version of NDIS on which Protocol Manager is based
  878. SeeAlso: #0736,#0737,#0738,#0739,#0740,#0741,#0742,#0743,#0744
  879.  
  880. Format of NDIS request block for RegisterModule:
  881. Offset    Size    Description    (Table 0736)
  882.  00h    WORD    02h
  883.  02h    WORD    returned status (see #0745)
  884.  04h    DWORD    pointer to module's common characteristics table (see #0746)
  885.  08h    DWORD    pointer to list of modules to which the module is to be bound
  886.  0Ch    WORD    unused
  887. SeeAlso: #0735,#0737,#0738,#0739,#0740,#0741,#0742,#0743,#0744
  888.  
  889. Format of NDIS request block for BindAndStart:
  890. Offset    Size    Description    (Table 0737)
  891.  00h    WORD    03h
  892.  02h    WORD    returned status (see #0745)
  893.  04h    DWORD    caller's virtual address in FailingModules structure
  894.  08h    DWORD    unused
  895.  0Ch    WORD    unused
  896. SeeAlso: #0735,#0736,#0738,#0739,#0740,#0741,#0742,#0743,#0744
  897.  
  898. Format of NDIS request block for GetProtocolManagerLinkage:
  899. Offset    Size    Description    (Table 0738)
  900.  00h    WORD    04h
  901.  02h    WORD    returned status (see #0745)
  902.  04h    DWORD    returned dispatch point
  903.  08h    DWORD    unused
  904.  0Ch    WORD    returned protocol manager DS
  905. Note:    the dispatch point may be called as follows instead of using this IOCTL
  906.     STACK: WORD  protocol manager DS
  907.            DWORD pointer to request block
  908.     Return: AX = returned status
  909.         STACK popped
  910. SeeAlso: #0735,#0736,#0737,#0739,#0740,#0741,#0742,#0743,#0744
  911.  
  912. Format of NDIS request block for GetProtocolIniPath:
  913. Offset    Size    Description    (Table 0739)
  914.  00h    WORD    05h
  915.  02h    WORD    returned status (see #0745)
  916.  04h    DWORD    pointer to a buffer for the ASCIZ pathname of PROTOCOL.INI
  917.  08h    DWORD    unused
  918.  0Ch    WORD    buffer length
  919. SeeAlso: #0735,#0736,#0737,#0738,#0740,#0741,#0742,#0743,#0744
  920.  
  921. Format of NDIS request block for RegisterProtocolManagerInfo:
  922. Offset    Size    Description    (Table 0740)
  923.  00h    WORD    06h
  924.  02h    WORD    returned status (see #0745)
  925.  04h    DWORD    pointer to structure containing parsed user config file
  926.  08h    DWORD    unused
  927.  0Ch    WORD    length of structure
  928. SeeAlso: #0735,#0736,#0737,#0738,#0739,#0741,#0742,#0743,#0744
  929.  
  930. Format of NDIS request block for InitAndRegister:
  931. Offset    Size    Description    (Table 0741)
  932.  00h    WORD    07h
  933.  02h    WORD    returned status (see #0745)
  934.  04h    DWORD    unused
  935.  08h    DWORD    poitner to ASCIZ name of the module to be prebind initialized
  936.  0Ch    WORD    unused
  937. SeeAlso: #0735,#0736,#0737,#0738,#0739,#0740,#0742,#0743,#0744
  938.  
  939. Format of NDIS request block for UnbindAndStop:
  940. Offset    Size    Description    (Table 0742)
  941.  00h    WORD    08h
  942.  02h    WORD    returned status (see #0745)
  943.  04h    DWORD    failing modules as for BindAndStart
  944.  08h    DWORD    if not 0000h:0000h, pointer to ASCIZ name of module to unbind
  945.         if 0000h:0000h, terminate a set of previously dynamically
  946.           bound protocol modules
  947.  0Ch    WORD    unused
  948. SeeAlso: #0735,#0736,#0737,#0738,#0739,#0740,#0741,#0743,#0744
  949.  
  950. Format of NDIS request block for BindStatus:
  951. Offset    Size    Description    (Table 0743)
  952.  00h    WORD    09h
  953.  02h    WORD    returned status (see #0745)
  954.  04h    DWORD    must be 0000h:0000h
  955.         on return, points to root tree
  956.  08h    DWORD    0000h:0000h
  957.  0Ch    WORD    unused under DOS
  958. SeeAlso: #0735,#0736,#0737,#0738,#0739,#0740,#0741,#0742,#0744
  959.  
  960. Format of NDIS request block for RegisterStatus:
  961. Offset    Size    Description    (Table 0744)
  962.  00h    WORD    0Ah
  963.  02h    WORD    returned status (0000h, 0008h, 002Ch) (see #0745)
  964.  04h    DWORD    0000h:0000h
  965.  08h    DWORD    pointer to 16-byte ASCIZ module name
  966.  0Ch    WORD    0000h
  967. Note:    not supported by the 10NET v5.0 PROTMAN$ driver
  968. SeeAlso: #0735,#0736,#0737,#0738,#0739,#0740,#0741,#0742,#0743
  969.  
  970. (Table 0745)
  971. Values for NDIS status code:
  972.  0000h    success
  973.  0001h    wait for release--protocol has retained control of the data buffer
  974.  0002h    request queued
  975.  0003h    frame not recognized
  976.  0004h    frame rejected
  977.  0005h    frame should be forwarded
  978.  0006h    out of resource
  979.  0007h    invalid parameter
  980.  0008h    invalid function
  981.  0009h    not supported
  982.  000Ah    hardware error
  983.  000Bh    transmit error
  984.  000Ch    unrecognized destination
  985.  000Dh    buffer too small
  986.  0020h    already started
  987.  0021h    binding incomplete
  988.  0022h    driver not initialized
  989.  0023h    hardware not found
  990.  0024h    hardware failure
  991.  0025h    configuration failure
  992.  0026h    interrupt conflict
  993.  0027h    MAC incompatible
  994.  0028h    initialization failed
  995.  0029h    no binding
  996.  002Ah    network may be disconnected
  997.  002Bh    incompatible OS version
  998.  002Ch    already registered
  999.  002Dh    path not found
  1000.  002Eh    insufficient memory
  1001.  002Fh    info not found
  1002.  00FFh    general failure
  1003.  F000h-FFFFh reserved for vendor-specific codes, treated as general failure
  1004.  
  1005. Format of NDIS common characteristics table:
  1006. Offset    Size    Description    (Table 0746)
  1007.  00h    WORD    size of table in bytes
  1008.  02h    BYTE    NDIS major version
  1009.  03h    BYTE    NDIS minor version
  1010.  04h    WORD    reserved
  1011.  06h    BYTE    module major version
  1012.  07h    BYTE    module minor version
  1013.  08h    DWORD    module function flag bits
  1014.         bit 0: binding at upper boundary supported
  1015.         bit 1: binding at lower boundary supported
  1016.         bit 2: dynamically bound
  1017.         bits 3-31 reserved, must be 0
  1018.  0Ch 16 BYTEs    ASCIZ module name
  1019.  1Ch    BYTE    upper boundary protocol level (see #0747)
  1020.  1Dh    BYTE    upper boundary interface type
  1021.         for MACs: 1 = MAC
  1022.         for data links and transports: to be defined
  1023.         for session: 1 = NCB
  1024.         any level: 0 = private (ISV-defined)
  1025.  1Eh    BYTE    lower boundary protocol level (see #0747)
  1026.  1Fh    BYTE    lower boundary interface type
  1027.         same as offset 1Dh
  1028.  20h    WORD    module ID filled in by protocol manager
  1029.  22h    WORD    module DS
  1030.  24h    DWORD    system request entry point
  1031.  28h    DWORD    pointer to service-specific characteristics (see #0749,#0751)
  1032.         0000h:0000h if none
  1033.  2Ch    DWORD    pointer to service-specific status, or 0000h:0000h if none
  1034.           (see #0752)
  1035.  30h    DWORD    pointer to upper dispatch table (see #0748)
  1036.         0000h:0000h if none
  1037.  34h    DWORD    pointer to lower dispatch table (see #0748)
  1038.         0000h:0000h if none
  1039.  38h  2 DWORDs    reserved, must be 0
  1040. Note:    for compatibility with NDIS 1.x.x, a major version of 00h is
  1041.       interpreted as 01h
  1042.  
  1043. (Table 0747)
  1044. Values for NDIS boundary protocol level:
  1045.  00h    physical
  1046.  01h    Media Access Control
  1047.  02h    Data link
  1048.  03h    network
  1049.  04h    transport
  1050.  05h    session
  1051.  FFh    not specified
  1052.  
  1053. Format of NDIS dispatch table:
  1054. Offset    Size    Description    (Table 0748)
  1055.  00h    DWORD    -> common characteristics table (see #0746)
  1056.  04h  4 BYTEs    ???
  1057.  08h    DWORD    -> ??? function (called with 12 bytes of stack arguments)
  1058.  0Ch    DWORD    -> ??? function (called with 10 bytes of stack arguments)
  1059.  10h    DWORD    -> ??? function (called with 16 bytes of stack arguments)
  1060.  14h    DWORD    -> ??? function (called with 4 bytes of stack arguments)
  1061.  18h    DWORD    -> ??? function (called with 18 bytes of stack arguments)
  1062.  1Ch    DWORD    -> ??? function (called with 12 bytes of stack arguments)
  1063.  
  1064. Format of MAC Service-Specific Characteristics Table:
  1065. Offset    Size    Description    (Table 0749)
  1066.  00h    WORD    length of table in bytes
  1067.  02h 16 BYTEs    ASCIZ MAC type name, "802.3", "802.4", "802.5", "802.6", "DIX",
  1068.           "DIX+802.3", "APPLETALK", "ARCNET", "FDDI", "SDLC", "BSC",
  1069.           "HDLC", or "ISDN"
  1070.  12h    WORD    length of station addresses in bytes
  1071.  14h 16 BYTEs    permanent station address
  1072.  24h 16 BYTEs    current station address
  1073.  34h    DWORD    current functional adapter address (00000000h if none)
  1074.  38h    DWORD    pointer to multicast address list
  1075.  3Ch    DWORD    link speed in bits/sec
  1076.  40h    DWORD    service flags (see #0750)
  1077.  44h    WORD    maximum frame size which may be both sent and received
  1078.  46h    DWORD    total transmit buffer capacity in bytes
  1079.  4Ah    WORD    transmit buffer allocation block size in bytes
  1080.  4Ch    DWORD    total receive buffer capacity in bytes
  1081.  50h    WORD    receive buffer allocation block size in bytes
  1082.  52h  3 BYTEs    IEEE vendor code
  1083.  55h    BYTE    vendor adapter code
  1084.  56h    DWORD    pointer to ASCIZ vendor adapter description
  1085.  5Ah    WORD    IRQ used by adapter
  1086.  5Ch    WORD    transmit queue depth
  1087.  5Eh    WORD    maximum supported number of data blocks in buffer descriptors
  1088.  60h  N BYTEs    vendor-specific info
  1089. SeeAlso: #0751
  1090.  
  1091. Bitfields for service flags:
  1092. Bit(s)    Description    (Table 0750)
  1093.  0    supports broadcast
  1094.  1    supports multicast
  1095.  2    supports functional/group addressing
  1096.  3    supports promiscuous mode
  1097.  4    station address software settable
  1098.  5    statistics always current
  1099.  6    supports InitiateDiagnostics
  1100.  7    supports loopback
  1101.  8    MAC does primarily ReceiveChain indications instead of ReceiveLookahead
  1102.     indications
  1103.  9    supports IBM source routing
  1104.  10    supports MAC reset
  1105.  11    supports Open/Close adapter
  1106.  12    supports interrupt request
  1107.  13    supports source routing bridge
  1108.  14    supports GDT virtual addresses (OS/2 version)
  1109.  15    multiple TransferDatas allowed durign a single indication
  1110.  16    MAC normally sets FrameSize = 0 in ReceiveLookahead
  1111.  17-31    reserved, must be 0
  1112.  
  1113. Format of NetBIOS Service-Specific Characteristics Table:
  1114. Offset    Size    Description    (Table 0751)
  1115.  00h    WORD    length of table in bytes
  1116.  02h 16 BYTEs    ASCIZ type name of NetBIOS module
  1117.  12h    WORD    NetBIOS module code
  1118.  14h  N BYTEs    vendor-specific info
  1119. SeeAlso: #0749
  1120.  
  1121. Format of MAC Service-Specific Status Table:
  1122. Offset    Size    Description    (Table 0752)
  1123.  00h    WORD    length of table in bytes
  1124.  02h    DWORD    seconds since 0:00 1/1/70 when diagnostics last run
  1125.         (FFFFFFFFh = never)
  1126.  06h    DWORD    MAC status bits (see #0753)
  1127.  0Ah    WORD    current packet filter flags (see #0754)
  1128.  0Ch    DWORD    pointer to media-specific status table or 0000h:0000h
  1129.  10h    DWORD    seconds past 0:00 1/1/70 of last ClearStatistics
  1130.  14h    DWORD    total frames received (FFFFFFFFh = not counted)
  1131.  18h    DWORD    frames with CRC error (FFFFFFFFh = not counted)
  1132.  1Ch    DWORD    total bytes received (FFFFFFFFh = not counted)
  1133.  20h    DWORD    frames discarded--no buffer space (FFFFFFFFh = not counted)
  1134.  24h    DWORD    multicast frames received (FFFFFFFFh = not counted)
  1135.  28h    DWORD    broadcast frames received (FFFFFFFFh = not counted)
  1136.  2Ch    DWORD    frames with errors (FFFFFFFFh = not counted)
  1137.  30h    DWORD    overly large frames (FFFFFFFFh = not counted)
  1138.  34h    DWORD    frames less than minimum size (FFFFFFFFh = not counted)
  1139.  38h    DWORD    multicast bytes received (FFFFFFFFh = not counted)
  1140.  3Ch    DWORD    broadcast bytes received (FFFFFFFFh = not counted)
  1141.  40h    DWORD    frames discarded--hardware error (FFFFFFFFh = not counted)
  1142.  44h    DWORD    total frames transmitted (FFFFFFFFh = not counted)
  1143.  48h    DWORD    total bytes transmitted (FFFFFFFFh = not counted)
  1144.  4Ch    DWORD    multicast frames transmitted (FFFFFFFFh = not counted)
  1145.  50h    DWORD    broadcast frames transmitted (FFFFFFFFh = not counted)
  1146.  54h    DWORD    broadcast bytes transmitted (FFFFFFFFh = not counted)
  1147.  58h    DWORD    multicast bytes transmitted (FFFFFFFFh = not counted)
  1148.  5Ch    DWORD    frames not transmitted--timeout (FFFFFFFFh = not counted)
  1149.  60h    DWORD    frames not transmitted--hardware error (FFFFFFFFh = not countd)
  1150.  64h  N BYTEs    vendor-specific info
  1151.  
  1152. Bitfields for MAC status bits:
  1153. Bit(s)    Description    (Table 0753)
  1154.  0-2    operational status
  1155.     000 hardware not installed
  1156.     001 hardware failed startup diagnostics
  1157.     010 hardware configuration problem
  1158.     011 hardware fault
  1159.     100 operating marginally due to soft faults
  1160.     101 reserved
  1161.     110 reserved
  1162.     111 hardware fully operational
  1163.  3    MAC bound
  1164.  4    MAC open
  1165.  5    diagnostics in progress
  1166.  6-31    reserved
  1167.  
  1168. Bitfields for packet filter flags:
  1169. Bit(s)    Description    (Table 0754)
  1170.  0    directed/multicast or group/functional
  1171.  1    broadcast
  1172.  2    promiscuous
  1173.  3    all source routing
  1174.  4-15    reserved, must be zero
  1175. --------I-214402-----------------------------
  1176. INT 21 U - IBM SYSTEM 36/38 WORKSTATION EMULATION - VDI.SYS - GET ???
  1177.     AX = 4402h
  1178.     BX = handle for character device "GDMS"
  1179.     CX = number of bytes to read (>= 4)
  1180.     DS:DX -> buffer (see #0755)
  1181. Return: CF set on error
  1182.         AX = error code (see #0980 at AH=59h)
  1183.     CF clear if successful
  1184.         AX = number of bytes read
  1185.  
  1186. Format of System 36/38 emulator returned data:
  1187. Offset    Size    Description    (Table 0755)
  1188.  00h  4 BYTEs    ???
  1189.  04h    DWORD    pointer to ???
  1190.  08h  4 BYTEs    ???
  1191. --------m-214402-----------------------------
  1192. INT 21 U - LASTBYTE.SYS v1.19 - IOCTL - GET ??? TABLE
  1193.     AX = 4402h
  1194.     BX = handle for device "LA$TBYTE"
  1195.     CX = 0004h
  1196.     DS:DX -> DWORD to hold address of 39-byte table of ???
  1197. Return: CF set on error
  1198.         AX = error code (see #0980 at AH=59h)
  1199.     CF clear if successful
  1200.         AX = number of bytes read
  1201. Program: LASTBYTE.SYS is part of the shareware "The Last Byte" memory
  1202.       management package by Key Software Products
  1203. SeeAlso: AX=4402h"HIGHUMM"
  1204. --------m-214402-----------------------------
  1205. INT 21 - HIGHUMM.SYS v1.17+ - IOCTL - GET API ADDRESS
  1206.     AX = 4402h
  1207.     BX = handle for device "KSP$UMM"
  1208.     CX = 0004h
  1209.     DS:DX -> DWORD to hold entry point (see #0756)
  1210. Return: CF set on error
  1211.         AX = error code (see #0980 at AH=59h)
  1212.     CF clear if successful
  1213.         AX = number of bytes read
  1214. Program: HIGHUMM.SYS is part of the shareware "The Last Byte" memory management
  1215.       package by Key Software Products
  1216. SeeAlso: AX=4402h"LASTBYTE"
  1217.  
  1218. (Table 0756)
  1219. Call HIGHUMM.SYS entry point with:
  1220.     AH = 00h allocate UMB (same as XMS function 10h) (see INT 2F/AX=4310h)
  1221.         DX = size in paragraphs
  1222.         Return: BX = segment number (if successful)
  1223.             DX = size of requested block/size of largest block
  1224.     AH = 01h deallocate UMB (same as XMS func 11h) (see INT 2F/AX=4310h)
  1225.         DX = segment number of UMB
  1226.     AH = 02h request a bank-switched memory block
  1227.         DX = size in paragraphs
  1228.         Return: BX = segment number (if successful)
  1229.             DX = size of requested block/size of largest block
  1230.     AH = 03h release a bank-switched memory block
  1231.         DX = segment number
  1232.     AH = 04h transfer data to/from high memory
  1233.         DS:SI -> source
  1234.         ES:DI -> destination
  1235.         CX = length in bytes
  1236.         Note: enables bank-switched memory, does the copy, then disables
  1237.         bank-switched memory
  1238.     AH = 05h get a word from bank-switched memory
  1239.         ES:DI -> word to read
  1240.         Return: DX = word
  1241.     AH = 06h put a word to bank-switched memory
  1242.         ES:DI -> word to write
  1243.         DX = word
  1244.     AH = 07h put a byte to bank-switched memory
  1245.         ES:DI -> byte to write
  1246.         DL = byte
  1247.     AH = 08h enable bank-switched memory
  1248.         DS:SI -> 6-byte status save area
  1249.     AH = 09h disable bank-switched memory
  1250.         DS:SI -> 6-byte save area from enable call (AH=08h)
  1251.     AH = 0Ah assign name to UMB or high bank-switched block
  1252.         DX = segment number
  1253.         DS:SI -> 8-byte blank-padded name
  1254.     AH = 0Bh locate UMB block by name
  1255.         DS:SI -> 8-byte blank-padded name
  1256.         Return: BX = segment number (if successful)
  1257.             DX = size of block
  1258.     AH = 0Ch locate bank-switched block by name
  1259.         DS:SI -> 8-byte blank-padded name
  1260.         Return: BX = segment number (if successful)
  1261.             DX = size of block
  1262. Return: AX = status code
  1263.         0001h successful
  1264.         0000h failed
  1265.         BL = error code
  1266.             80h not implemented
  1267.             B0h insufficient memory, smaller block available
  1268.             B1h insufficient memory, no blocks available
  1269.             B2h invalid segment number
  1270. Note:    only functions 00h and 01h are always available; the remaining
  1271.       functions are only enabled if the proper commandline switch is given
  1272. --------c-214402-----------------------------
  1273. INT 21 - SMARTDRV.SYS v3.x only - IOCTL - GET CACHE STATUS
  1274.     AX = 4402h
  1275.     BX = file handle for device "SMARTAAR"
  1276.     CX = number of bytes to read (min 28h)
  1277.     DS:DX -> buffer for status record (see #0757)
  1278. Return: CF clear if successful
  1279.         AX = number of bytes actually read
  1280.     CF set on error
  1281.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  1282. Note:    NCache2 (from the Norton Utilities v8.0) attempts to support this
  1283.       interface, but does not do so correctly, often hanging the system;
  1284.       one should use the SmartDrive v4.x or NCache private interfaces
  1285.       (see INT 2F/AX=4A10h/BX=0000h,INT 2F/AX=FE00h/DI=4E55h)
  1286. SeeAlso: AX=4403h"SMARTDRV",INT 2F/AX=4A10h/BX=0000h
  1287.  
  1288. Format of SMARTDRV status record:
  1289. Offset    Size    Description    (Table 0757)
  1290.  00h    BYTE    write-through flag (always 01h)
  1291.  01h    BYTE    writes should be buffered (always 00h)
  1292.  02h    BYTE    cache enabled if 01h
  1293.  03h    BYTE    driver type (01h extended memory, 02h expanded)
  1294.  04h    WORD    clock ticks between cache flushes (currently unused)
  1295.  06h    BYTE    cache contains locked tracks if nonzero
  1296.  07h    BYTE    flush cache on INT 19 reboot if nonzero
  1297.  08h    BYTE    cache full track writes if nonzero
  1298.  09h    BYTE    double buffering (for VDS) state (00h off, 01h on, 02h dynamic)
  1299.  0Ah    DWORD    original INT 13 vector
  1300.  0Eh    BYTE    minor version number
  1301.  0Fh    BYTE    major version number
  1302.  10h    WORD    unused
  1303.  12h    WORD    sectors read            \
  1304.  14h    WORD    sectors already in cache     > may be scaled rather than
  1305.  16h    WORD    sectors already in track buffer /  absolute counts
  1306.  18h    BYTE    cache hit rate in percent
  1307.  19h    BYTE    track buffer hit rate in percent
  1308.  1Ah    WORD    total tracks in cache
  1309.  1Ch    WORD    number of tracks in use
  1310.  1Eh    WORD    number of locked tracks
  1311.  20h    WORD    number of dirty tracks
  1312.  22h    WORD    current cache size in 16K pages
  1313.  24h    WORD    original (maximum) cache size in 16K pages
  1314.  26h    WORD    minimum cache size in 16K pages
  1315.  28h    DWORD    pointer to byte flag to increment for locking cache contents
  1316. --------d-214402-----------------------------
  1317. INT 21 - CD-ROM device driver - IOCTL INPUT
  1318.     AX = 4402h
  1319.     BX = file handle referencing character device for CD-ROM driver
  1320.     CX = number of bytes to read
  1321.     DS:DX -> control block (see #0759)
  1322. Return: CF clear if successful
  1323.         AX = number of bytes actually read
  1324.     CF set on error
  1325.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  1326. Note:    the data returned depends on the first byte of the control block; the
  1327.       remainder of the control block is filled by the driver
  1328. SeeAlso: AX=4403h"CD-ROM",INT 2F/AX=0802h
  1329.  
  1330. (Table 0758)
  1331. Values for CD-ROM data being requested:
  1332.  00h    device driver header address
  1333.  01h    drive head location
  1334.  02h    reserved
  1335.  03h    error statistics
  1336.  04h    audio channel info
  1337.  05h    raw drive bytes (uninterpreted and device-specific)
  1338.  06h    device status
  1339.  07h    sector size
  1340.  08h    volume size
  1341.  09h    media change status
  1342.  0Ah    audio disk info
  1343.  0Bh    audio track info
  1344.  0Ch    audio Q-Channel info
  1345.  0Dh    audio sub-channel info
  1346.  0Eh    UPC code
  1347.  0Fh    audio status info
  1348.  
  1349. Format of CD-ROM control block:
  1350. Offset    Size    Description    (Table 0759)
  1351.  00h    BYTE    data being requested (see #0758)
  1352. ---function 00h---
  1353.  01h    DWORD    device driver header address (see also AH=52h,#0953)
  1354. ---function 01h---
  1355.  01h    BYTE    addressing mode
  1356.         00h HSG
  1357.         01h Red Book
  1358.  02h    DWORD    current location of drive's head
  1359.         logical sector number in HSG mode
  1360.         frame/second/minute/unused in Red Book mode
  1361.         (HSG sector = minute * 4500 + second * 75 + frame - 150)
  1362. ---function 03h---
  1363.  01h  N BYTEs    undefined as of 5 Aug 88 specification
  1364. ---function 04h---
  1365.  01h    BYTE    input channel (0-3) for output channel 0
  1366.  02h    BYTE    volume for output channel 0
  1367.  03h    BYTE    input channel (0-3) for output channel 1
  1368.  04h    BYTE    volume for output channel 1
  1369.  05h    BYTE    input channel (0-3) for output channel 2
  1370.  06h    BYTE    volume for output channel 2
  1371.  07h    BYTE    input channel (0-3) for output channel 3
  1372.  08h    BYTE    volume for output channel 3
  1373. Notes:    output channels 0 and 1 are left and right, 2 and 3 are left prime and
  1374.       right prime; a volume of 00h is off
  1375.     the default setting is for each input channel to be assigned to the
  1376.       same-numbered output channel at full (FFh) volume
  1377. ---function 05h---
  1378.  01h    BYTE    number of bytes read
  1379.  02h 128 BYTEs    buffer for drive bytes
  1380. ---function 06h---
  1381.  01h    DWORD    device parameters (see #0760)
  1382. ---function 07h---
  1383.  01h    BYTE    read mode
  1384.         00h cooked
  1385.         01h raw
  1386.  02h    WORD    sector size in bytes
  1387. ---function 08h---
  1388.  01h    DWORD    volume size in sectors
  1389. ---function 09h---
  1390.  01h    BYTE    media change status
  1391.         00h don't know
  1392.         01h media unchanged
  1393.         FFh media has been changed
  1394. ---function 0Ah---
  1395.  01h    BYTE    lowest audio track number
  1396.  02h    BYTE    highest audio track number
  1397.  03h    DWORD    start address of lead-out track (Red Book format)
  1398. --function 0Bh---
  1399.  01h    BYTE    track number (set by caller)
  1400.  02h    DWORD    starting point of track (Red Book format)
  1401.  06h    BYTE    track control info
  1402.         bits 15,14,12: track type (notice: bits not contiguous!)
  1403.             000 two audio channels, no pre-emphasis
  1404.             001 two audio channels with pre-emphasis
  1405.             010 data track
  1406.             100 four audio channels, no pre-emphasis
  1407.             101 four audio channels with pre-emphasis
  1408.             other reserved
  1409.         bit 13: digital copy permitted
  1410. ---function 0Ch---
  1411.  01h    BYTE    CONTROL and ADR byte (as received from drive)
  1412.  02h    BYTE    track number
  1413.  03h    BYTE    point or index
  1414.  04h    BYTE    minute    \
  1415.  05h    BYTE    second     > running time within track
  1416.  06h    BYTE    frame    /
  1417.  07h    BYTE    zero
  1418.  08h    BYTE    "AMIN" or "PMIN"     \
  1419.  09h    BYTE    "ASEC" or "PSEC"      > running time on disk
  1420.  0Ah    BYTE    "AFRAME" or "PFRAME" /
  1421. ---function 0Dh---
  1422.  01h    DWORD    starting frame address (Red Book format)
  1423.  05h    DWORD    transfer address
  1424.  09h    DWORD    number of sectors to read
  1425. Note:    copies 96 bytes of sub-channel info per sector into buffer
  1426. ---function 0Eh---
  1427.  01h    BYTE    CONTROL and ADR byte
  1428.  02h  7 BYTEs    UPC/EAN code (13 BCD digits,low-order nybble of last byte is 0)
  1429.  09h    BYTE    zero
  1430.  0Ah    BYTE    "AFRAME"
  1431. ---function 0Fh---
  1432.  ??? documentation not yet available
  1433.  01h    WORD    pause status (0000h not paused, 0001h paused)
  1434.  03h    DWORD    audio play start address
  1435.  07h    DWORD    ??? audio play length or end address
  1436.  
  1437. Bitfields for CD-ROM device parameters:
  1438. Bit(s)    Description    (Table 0760)
  1439.  0    door open
  1440.  1    door unlocked
  1441.  2    supports raw reading in addition to cooked
  1442.  3    writable
  1443.  4    can play audio/video tracks
  1444.  5    supports interleaving
  1445.  6    reserved
  1446.  7    supports prefetch requests
  1447.  8    supports audio channel control
  1448.  9    supports Red Book addressing in addition to HSG
  1449.  10    audio is playing
  1450.  11    no disk in drive
  1451.  12    supports R-W subchannels
  1452. --------m-214402-----------------------------
  1453. INT 21 - Quarterdeck - QEMM-386 v5+ - GET API ENTRY POINT
  1454.     AX = 4402h
  1455.     BX = file handle for device "QEMM386$"
  1456.     CX = 0004h
  1457.     DS:DX -> DWORD buffer for API entry point
  1458. Return: CF clear if successful
  1459.         buffer filled (see INT 67/AH=3Fh for entry point parameters)
  1460.     CF set on error
  1461.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  1462. Note:    Quarterdeck recently (June 1993) documented this function, but the
  1463.       documentation incorrectly states that it is only available for
  1464.       QEMM 6+
  1465. SeeAlso: AX=4402h"HOOKROM",INT 2F/AX=D201h/BX=5145h,INT 67/AH=3Fh
  1466. --------Q-214402-----------------------------
  1467. INT 21 U - Quarterdeck - HOOKROM.SYS - GET HOOKED VECTOR TABLE
  1468.     AX = 4402h
  1469.     BX = file handle for device "HOOKROM$"
  1470.     CX = 0004h
  1471.     DS:DX -> DWORD buffer for address of hooked vector table (see #0761)
  1472. Return: CF clear if successful
  1473.         DS:DX buffer filled
  1474.     CF set on error
  1475.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  1476. SeeAlso: AX=4402h/SF=01h
  1477.  
  1478. Format of HOOKROM.SYS hooked vector table entry:
  1479. Offset    Size    Description    (Table 0761)
  1480.  00h  5 BYTEs    FAR jump to actual interrupt handler
  1481.         (end of table if first byte is not EAh)
  1482.  05h    BYTE    interrupt vector number
  1483. --------d-214402-----------------------------
  1484. INT 21 - Advanced SCSI Programming Interface (ASPI) - INTERFACE
  1485.     AX = 4402h
  1486.     BX = file handle for device "SCSIMGR$"
  1487.     CX = 0004h or 0005h (see notes)
  1488.     DS:DX -> buffer for result (see #0762), set to zeros before call
  1489. Return: CF clear if successful
  1490.         AX = 0004h or 0005h (see notes)
  1491.     CF set on error
  1492.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  1493. Note:    the variant of the call requesting five bytes is an UNDOCUMENTED
  1494.       extension supported by Adaptec's ASPI2DOS.SYS, ASPI4DOS.SYS, and
  1495.       ASPI7DOS.SYS; if made of a host manager which does not support the
  1496.       variant, only four bytes will be returned.  If the variant is
  1497.       supported, Adaptec's WINASPI.DLL assumes that the host manager is
  1498.       an "advanced" one which operates in either real or protected mode
  1499.       (and thus does not require a DPMI INT 31/AX=0301h call to be invoked
  1500.       from protected mode).     Support of the five-byte variant also appears
  1501.       to imply that an advanced ASPI host manager uses no temporary
  1502.       storage space except the SRB (see #0764) and the stack, and that it
  1503.       is fully reentrant.
  1504.     if called with a standard request for four bytes, even Adaptec's
  1505.       advanced drivers return only the requested four bytes containing the
  1506.       ASPI entry point address
  1507.     the function address is called with the address of a SCSI Request
  1508.       Block (see #0764) on the stack and the caller must clean up the
  1509.       stack
  1510. SeeAlso: AX=440Ch"ASPITAPE",INT 11/AH=FFh"WD7000"
  1511.  
  1512. Format of ASPI IOCTL result:
  1513. Offset    Size    Description    (Table 0762)
  1514.  00h    DWORD    function address
  1515.  04h    BYTE    number of SCSI host adapters supported by host manager
  1516.  
  1517. (Table 0763)
  1518. Values for ASPI request number:
  1519.  00h    "HA_INQ"    host adapter inquiry
  1520.  01h    "GET_TYPE"    get device type
  1521.  02h    "EXEC_SIO"    execute SCSI I/O
  1522.  03h    "ABORT_SRB"    abort SRB
  1523.  04h    "RESET_DEV"    reset SCSI device
  1524.  05h    "SET_HAPRMS"    set host adapter parameters
  1525.  06h    get disk drive information
  1526.  
  1527. Format of SCSI Request Block (64 bytes):
  1528. Offset    Size    Description    (Table 0764)
  1529.  00h    BYTE    request number (see #0763)
  1530.  01h    BYTE    request status (see #0765)
  1531.  02h    BYTE    host adapter ID
  1532.  03h    BYTE    request flags (see #0766)
  1533.  04h    DWORD    reserved
  1534. ---request 00h---
  1535.  08h    BYTE    (ret) number of host adapters
  1536.  09h    BYTE    (ret) target adapter ID
  1537.  0Ah 16 BYTEs    (ret) SCSI manager ID
  1538.  1Ah 16 BYTEs    (ret) host adapter ID
  1539.  2Ah 16 BYTEs    (ret) host adapter-unique parameters
  1540. ---request 01h---
  1541.  08h    BYTE    target ID
  1542.  09h    BYTE    logical unit number
  1543.  0Ah    BYTE    (ret) device type (see #0769)
  1544. ---request 02h---
  1545.  08h    BYTE    target ID
  1546.  09h    BYTE    logical unit number
  1547.  0Ah    DWORD    data allocation length
  1548.  0Eh    BYTE    sense allocation length
  1549.  0Fh    DWORD    data buffer pointer
  1550.  13h    DWORD    next request pointer (for linking)
  1551.  17h    BYTE    CDB length
  1552.  18h    BYTE    (ret) host adapter status (see #0764)
  1553.  19h    BYTE    (ret) target status (see #0768)
  1554.  1Ah    DWORD    post routine address
  1555.  1Eh    WORD    real mode Post DS
  1556.  20h    DWORD    SRB pointer
  1557.  24h    WORD    reserved
  1558.  26h    DWORD    SRB physical address
  1559.  2Ah 22 BYTEs    SCSIMGR$ workspace
  1560.  40h  N BYTEs    CCB, including sense data (20-24 bytes)
  1561. ---request 03h---
  1562.  08h    DWORD    address of SRB to abort
  1563. ---request 04h---
  1564.  08h    BYTE    target ID
  1565.  09h    BYTE    logical unit number
  1566.  0Ah 14 BYTEs    reserved
  1567.  18h    BYTE    (ret) host adapter status (see #0767)
  1568.  19h    BYTE    (ret) target status (see #0768)
  1569.  1Ah    DWORD    post routine address
  1570.  1Eh 34 BYTEs    workspace
  1571. ---request 05h---
  1572.  08h 16 BYTEs    host adapter-unique parameters
  1573. ---request 06h---
  1574.  08h    BYTE    target ID
  1575.  09h    BYTE    logical unit number
  1576.  0Ah    BYTE    disk drive flags (see #0770)
  1577.  0Bh    BYTE    INT 13h drive number
  1578.  0Ch    BYTE    preferred head number translation
  1579.  0Dh    BYTE    preferred sector size translation
  1580.  0Eh 10 BYTEs    reserved
  1581. SeeAlso: #0771
  1582.  
  1583. (Table 0765)
  1584. Values for ASPI request status:
  1585.  00h    not done yet
  1586.  01h    completed successfully
  1587.  02h    aborted by host
  1588.  04h    SCSI I/O error
  1589.  80h    invalid
  1590.  81h    no adapter
  1591.  82h    no device attached
  1592.  else    status
  1593.  
  1594. Bitfields for ASPI request flags:
  1595. Bit(s)    Description    (Table 0766)
  1596.  0    posting enabled
  1597.  1    linking enabled
  1598.  2    direction
  1599.  3    transfer from SCSI target to host
  1600.  4    transfer from host to SCSI target
  1601. Note:    no data is transferred if both bits 3 and 4 are set
  1602.  
  1603. (Table 0767)
  1604. Values for host adapter status:
  1605.  00h    no error detected
  1606.  11h    select timeout
  1607.  12h    data overrun
  1608.  13h    bus error
  1609.  14h    bus failure
  1610.  
  1611. (Table 0768)
  1612. Values for target status:
  1613.  00h    no status
  1614.  02h    sense data stored in SRB
  1615.  08h    target busy
  1616.  18h    reservation error
  1617.  
  1618. (Table 0769)
  1619. Values for device type:
  1620.  00h    disk drive
  1621.  01h    tape drive (streamer)
  1622.  02h    printer
  1623.  03h    processor
  1624.  04h    WORM drive
  1625.  05h    CD-ROM drive
  1626.  06h    scanner
  1627.  07h    optical drive
  1628.  08h    autochanger
  1629.  09h    communications device
  1630.  
  1631. (Table 0770)
  1632. Values for disk drive flags:
  1633.  00h    no INT 13 access
  1634.  01h    INT 13 with DOS access
  1635.  02h    INT 13 without DOS access
  1636.  03h    invalid flags
  1637.  
  1638. Format of CCB:
  1639. Offset    Size    Description    (Table 0771)
  1640.  00h    BYTE    command code (see #0772)
  1641.  01h    BYTE    flags
  1642.         bits 4-0: vary by function
  1643.         bits 7-5: logical unit number
  1644.  02h    BYTE    "adr_1"
  1645.  03h    BYTE    "adr_0"
  1646.  04h    BYTE    length
  1647.  05h    BYTE    control
  1648.     ...
  1649.  06h/0Ah 14 BYTEs buffer for sense data (see #0773)
  1650. SeeAlso: #0764
  1651.  
  1652. (Table 0772)
  1653. Values for CCB command code:
  1654.  00h    test unit ready
  1655.  01h    rewind
  1656.  03h    request sense data
  1657.  05h    get block size limits
  1658.  08h    Group 0 read
  1659.  0Ah    Group 0 write
  1660.  10h    write file marks
  1661.  11h    SCSI Space (set position?)
  1662.  12h    SCSI Inquire
  1663.  15h    set mode information
  1664.  16h    reserve SCSI device
  1665.  17h    release SCSI device
  1666.  19h    erase
  1667.  1Ah    request mode information
  1668.  1Bh    load/unload media
  1669.  1Dh    request target self-check
  1670.  24h    set window parameters
  1671.  25h    get window parameters
  1672.  28h    Group 1 read
  1673.  2Ah    Group 1 write
  1674.  31h    document feeder control
  1675.  34h    get scan data status
  1676. ---vendor-specific commands---
  1677.  D3h    get document feeder status
  1678.  D4h    set document feeder mode
  1679.  
  1680. Format of sense data:
  1681. Offset    Size    Description    (Table 0773)
  1682.  00h    BYTE    error code (bit 7 set if valid)
  1683.  01h    BYTE    segment number
  1684.  02h    BYTE    sense key
  1685.         bit 6: EOM
  1686.         bit 5: ILI
  1687.         bits 0-3: sense key (see #0774)
  1688.  03h  4 BYTEs    information bytes
  1689.  07h    BYTE    additional sense length (0Ah)
  1690.  08h  4 BYTEs    command-specific information
  1691.  0Ch    BYTE    additional sense code
  1692.  0Dh    BYTE    additional sense code qualifier
  1693.  0Eh    BYTE    field replaceable unit code
  1694.  0Fh  3 BYTEs    sense key specific bytes
  1695.  
  1696. (Table 0774)
  1697. Values for sense key:
  1698.  00h    no sense data
  1699.  02h    SCSI unit not ready
  1700.  03h    media error
  1701.  04h    unrecoverable hardware error
  1702.  05h    illegal parameter in CDB
  1703.  06h    target has been reset
  1704.  0Bh    target aborted command
  1705. --------m-214402-----------------------------
  1706. INT 21 U - Qualitas 386MAX v6.00+ - IOCTL INPUT - GET STATE
  1707.     AX = 4402h
  1708.     BX = file handle for device "386MAX$$"
  1709.     CX = number of bytes to read
  1710.     DS:DX -> BYTE 03h followed by 386MAX state buffer (see #0775)
  1711. Return: CF clear if successful
  1712.         buffer at DS:DX+1 filled
  1713.         AX = number of bytes actually copied
  1714.     CF set on error
  1715.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  1716. Notes:    if the value given in CX is less than the size of the state record
  1717.       (5Ah for v6.01, 66h for v7.00), only a partial state record will be
  1718.       returned
  1719.     the state is 40h bytes for 386MAX (actually ASTEMM) v2.20 ("386MAX$$"
  1720.       did not exist yet, use "QMMXXXX0" and then "EMMXXXX0" instead) and
  1721.       56h bytes for v5.11.
  1722.     to invoke 386MAX API functions, push DX onto the stack, load DX with
  1723.       the word at offset 25h in the returned state, load all other
  1724.       registers as needed for the desired function, and execute an
  1725.       OUT DX,AL or OUT DX,AX; DX will be set to the pushed value on return
  1726.       if it is not otherwise modified by the API function.    For safety,
  1727.       in case a function is not supported or 386MAX is not present, SP
  1728.       should be saved and restored around the API call.
  1729.     Windows 3.1 Standard mode, LAN Manager, and Windows for Workgroups all
  1730.       use the 386MAX API; LAN Manager and Windows for Workgroups reportedly
  1731.       make some calls incorrectly
  1732. SeeAlso: AX=4403h/SF=03h"386MAX",INT 67/AH=3Fh
  1733.  
  1734. Format of 386MAX v6.01+ state:
  1735. Offset    Size    Description    (Table 0775)
  1736.  -1    BYTE    (call) 03h
  1737.  00h  6 BYTEs    signature "386MAX"
  1738.  06h  4 BYTEs    version string "N;NN" or "N.NN" (i.e. "6;01" for v6.01)
  1739.         (';' by default; apparently changed to a period when 386MAX
  1740.         has linked high RAM into DOS's memory chain)
  1741.  0Ah    WORD    segment of low-memory portion of 386MAX.SYS
  1742.  0Ch  2 BYTEs    ???
  1743.  0Eh    WORD    segment of ??? memory block or 0000h
  1744.  10h    WORD    bit flags 1 (see #0776)
  1745.  12h    WORD    starting address of video memory in KB
  1746.  14h  2 BYTEs    ???
  1747.  16h    WORD    total high DOS memory in KB
  1748.  18h  2 BYTEs    ???
  1749.  1Ah    WORD    available shared memory in KB
  1750.  1Ch    WORD    KBytes extended memory used by 386MAX
  1751.  1Eh  2 BYTEs    ???
  1752.  20h    WORD    total extended memory in KB
  1753.  22h    WORD    IO port to write (OUT DX,AL) to invoke 386MAX INT 15 functions
  1754.  24h    WORD    IO port to write (OUT DX,AL) to invoke 386MAX API functions
  1755.           (see #0789)
  1756.  26h    WORD    ??? (depends on DOS version)
  1757.  28h    WORD    size of ??? in paragraphs
  1758.  2Ah    DWORD    machine type (see #0784)
  1759.  2Eh    DWORD    -> first DOS memory control block
  1760.  32h    WORD    system configuration flags (see #0777)
  1761.  34h    WORD    debugging flags 1 (see #0778)
  1762.  36h    WORD    debugging flags 2 (see #0779)
  1763.  38h  2 BYTEs    ???
  1764.  3Ah    WORD    segment of first MCB in high memory chain
  1765.  3Ch    WORD    feature flags 1 (see #0781)
  1766.  3Eh    WORD    feature flags 2 (see #0782)
  1767.  40h    WORD    feature flags 3 (see #0783)
  1768.  42h    WORD    segment of first 386MAX control block??? (see #0785)
  1769.  44h    WORD    amount of memory to report available on INT 15/AH=88h
  1770.  46h  4 BYTEs    ???
  1771.  4Ah    WORD    number of K at start of address space swapped with fast
  1772.           extended memory (SWAP= parameter)
  1773.  4Ch  2 BYTEs    ???
  1774.  4Eh    WORD    segment address of ???
  1775.  50h    WORD    debugging flags 3 (see #0780)
  1776.  52h    DWORD    old INT 21h
  1777.  56h    DWORD    pointer to 386MAX's EMS (INT 67h) handler
  1778. ---386MAX v7.00---
  1779.  5Ah    DWORD    KB of extended memory managed by 386MAX
  1780.  5Eh    DWORD    bytes of extended memory (EXT= parameter)
  1781.  62h  4 BYTEs    ???
  1782.  
  1783. Bitfields for 386MAX bit flags 1:
  1784. Bit(s)    Description    (Table 0776)
  1785.  1    ???
  1786.  2    allow A20 to be enabled/disabled???
  1787.  3    ??? (cleared by calling INT 67 functions or starting MSWindows)
  1788.  4    high RAM present???
  1789.  5    386MAX in AUTO mode
  1790.  6    386MAX enabled
  1791.  7    386MAX is providing EMS services
  1792.  8    ??? (affects API function 08h)
  1793.  9    A20 gate closed (A20 disabled) (see INT 15/AX=2402h)
  1794.  10    Weitek support enabled
  1795.  11    ???
  1796.  12    ROMs not shadowed???
  1797.  13    QPMS has been used
  1798.  14    ???
  1799.  15    ???
  1800.  
  1801. Bitfields for 386MAX system configuration flags:
  1802. Bit(s)    Description    (Table 0777)
  1803.  1    ROM compressed???
  1804.  3    ???
  1805.  5    386MAX loaded into high memory
  1806.  6    Microchannel bus
  1807.  7    Weitek math coprocessor detected
  1808.  9    ??? (also generates INT 01 on ??? and INT 03 on ???)
  1809.  11    PC/XT (thus only single 8259 interrupt controller present, DMA only
  1810.         in 1st megabyte, etc)
  1811.  13    LMLTOP= specified
  1812.  14    enable A20 control???
  1813.  15    ???
  1814.  
  1815. Bitfields for 386MAX debugging flags 1:
  1816. Bit(s)    Description    (Table 0778)
  1817.  0    DEBUG=LED
  1818.  1    DEBUG=X67
  1819.  2    DEBUG=INV
  1820.  3    DEBUG=EMSPTED
  1821.  4    DEBUG=JMP
  1822.  5    DEBUG=CALL
  1823.  6    DEBUG=HLT
  1824.  7    DEBUG=PMR
  1825.  8    DEBUG=CR3
  1826.  9    DEBUG=CAPS or DEBUG=INT
  1827.  10    DEBUG=RC
  1828.  11    DEBUG=ROM
  1829.  12    DEBUG=XM
  1830.  13    DEBUG=SOR
  1831.  14    DEBUG=XR
  1832.  15    DEBUG=EMSERR (generate INT 01 on returning error from EMS call)
  1833.  
  1834. Bitfields for 386MAX debugging flags 2:
  1835. Bit(s)    Description    (Table 0779)
  1836.  0    DEBUG=ROMSWAP
  1837.  1    DEBUG=UNSHADOWROM
  1838.  2    DEBUG=COMPROM
  1839.  3    DEBUG=DPMIPHYS
  1840.  4    DEBUG=ALLROM
  1841.  5    DEBUG=VMS
  1842.  6    DEBUG=XMS (generate INT 01 on XMS calls)
  1843.  7    DEBUG=I06
  1844.  8    DEBUG=VCPI
  1845.  9    DEBUG=XDMA
  1846.  10    DEBUG=X09
  1847.  13    DEBUG=I67 (generate INT 01 on every INT 67 call)
  1848.  14    DEBUG=EVM (generate INT 01 on entering V86 mode)
  1849.  15    DEBUG=EMSSAVE or DEBUG=VDS
  1850.  
  1851. Bitfields for 386MAX debugging flags 3:
  1852. Bit(s)    Description    (Table 0780)
  1853.  10    DEBUG=EPM
  1854.  12    DEBUG=ABIOS
  1855.  13    DEBUG=XMSPTED
  1856.  14    DEBUG=TIME
  1857.  15    DEBUG=SCRUB
  1858.  
  1859. Bitfields for 386MAX feature flags 1:
  1860. Bit(s)    Description    (Table 0781)
  1861.  1    Weitek present
  1862.  2    no DPMI services
  1863.  3    NODMA
  1864.  4    TERSE
  1865.  5    NOROM
  1866.  6    NOPARITY
  1867.  8    NOFLEX (IGNOREFLEXFRAME)
  1868.  11    don't create UMBs
  1869.  12    don't backfill below video memory (NOLOW)
  1870.  13    FRAME= specified
  1871.  14    EXT= specified
  1872.  15    NOEMS, allow prior expanded memory manager to provide EMS
  1873.  
  1874. Bitfields for 386MAX feature flags 2:
  1875. Bit(s)    Description    (Table 0782)
  1876.  0    UNSHIFT specified (FORCEA20 disabled)
  1877.  1    NOXRAM
  1878.  2    NOSCSI specified
  1879.  3    SCREEN specified
  1880.  4    enabled EISADMA
  1881.  5    slow DMA
  1882.  6    RESETKEYB specified
  1883.  7    ???
  1884.  9    TOP384
  1885.  10    ???
  1886.  11    NOWARMBOOT
  1887.  12    USE= specified
  1888.  13    ROM= specified
  1889.  
  1890. Bitfields for 386MAX feature flags 3:
  1891. Bit(s)    Description    (Table 0783)
  1892.  0    Windows3 support enabled
  1893.  1    SHADOWROM
  1894.  2    don't compress ROM (NOCOMPROM)
  1895.  3    ??? (related to PRGREG=)
  1896.  4    ??? (related to PRGREG=)
  1897.  5    SHADOWRAM
  1898.  6    DOS4 specified
  1899.  7    NOLOADHIGH
  1900.  8    NOPULSE
  1901.  11    FORCEA20
  1902.  12    DMA buffer enabled
  1903.  13    NOSCRUB
  1904.  15    NOFRAME
  1905.  
  1906. Bitfields for 386MAX machine type:
  1907. Bit(s)    Description    (Table 0784)
  1908.  12    Amstrad
  1909.  13    Epson
  1910.  14    Zenith Data Systems
  1911.  15    "ASEM"
  1912.  16    NEC
  1913.  17    "HPRS" model codes 69h and 6Ah
  1914.  18    Dell
  1915.  19    "CA"
  1916.  20    ITT (Xtra Business Systems/Alcatel)
  1917.  21    Toshiba 5100
  1918.  22    Olivetti
  1919.  23    Quadram Quad386 (BIOS model FEh, submodel A6h)
  1920.  24    Tandy???
  1921.  25    AST 386
  1922.  26    INBOARD, ??? version
  1923.  27    INBOARD, ??? version
  1924.  28    INBOARD, ??? version
  1925.  29    "HPRS"
  1926.  30    Compaq 386
  1927.  31    JET386
  1928.  
  1929. Format of 386MAX control block:
  1930. Offset    Size    Description    (Table 0785)
  1931.  00h    WORD    segment of next block (FFFFh if last)
  1932.  02h    WORD    segment of previous block (FFFFh if first)
  1933.  04h 12 BYTEs    filename
  1934.  10h    WORD    resident size in paragraphs
  1935.  12h    WORD    environment size???
  1936.  14h    WORD    real prsent environment size + 1 (0000h if ENVSAVE used)
  1937.  16h  2 BYTEs    ???
  1938.  18h    DWORD    initial size or SIZE=n in 386LOAD commandline
  1939.  1Ch    DWORD    SIZE=-1 ???
  1940.  20h    DWORD    SIZE= ???
  1941.  24h    BYTE    PRGREG= if specified, else FFh
  1942.  25h    BYTE    ENVREG= if specified, else FFh
  1943.  26h    BYTE    FlexFrame (00h not present, 01h present)
  1944.  27h  3 BYTEs    ???
  1945.  2Ah    BYTE    GROUP= or 00h if not present
  1946.  2Bh    BYTE    ???
  1947.  2Ch    WORD    PSP
  1948.  
  1949. Format of 386MAX high memory info record:
  1950. Offset    Size    Description    (Table 0786)
  1951.  00h    WORD    segment address of memory region
  1952.  02h    WORD    size of memory region in paragraphs
  1953.  04h    BYTE    type or flags???
  1954.         00h if locked out
  1955.         02h if EMS page frame
  1956.         04h if high RAM
  1957.         42h if ROM
  1958.  05h    BYTE    ???
  1959.  
  1960. Format of 386MAX ROM shadowing record:
  1961. Offset    Size    Description    (Table 0787)
  1962.  00h    WORD    logical start segment of ROM??? (may be used by BlueMAX when it
  1963.           squeezes together the ROMs to make room)
  1964.  02h    WORD    physical start segment of ROM
  1965.  04h  2 BYTEs    ???
  1966.  06h    WORD    size of shadowed ROM in paragraphs
  1967.  08h  2 BYTEs    ???
  1968.  0Ah    WORD    flags
  1969.         bit 15: shadowing enabled for this ROM???
  1970.         bit 14: ???
  1971.         bit 13: ???
  1972.         bit 12: ???
  1973.         bit 10: ???
  1974.  
  1975. (Table 0788)
  1976. Values for 386MAX memory type:
  1977.  00h    unused by EMS
  1978.  01h    DOS
  1979.  04h    page frame overlapping ROM???
  1980.  80h    high memory
  1981.  84h    page frame???
  1982.  87h    video ROM???
  1983. Note:    the type may be 00h (unused) if the 16K page is split among different
  1984.       uses (such as ROM and high RAM)
  1985.  
  1986. (Table 0789)
  1987. Call 386MAX API (via OUT DX,AL) with:
  1988.     STACK: WORD value for DX
  1989.     AH = 00h unused
  1990.         Return: AH = 84h (unsupported function)
  1991.     AH = 01h get high memory information
  1992.         ES:DI -> buffer for array of high memory info records
  1993.             (see #0786)
  1994.         Return: CX = number of records placed in buffer
  1995.     AH = 02h get shadowed ROM info
  1996.         ES:DI -> buffer for array of ROM shadowing records (see #0787)
  1997.         Return: CX = number of records placed in buffer
  1998.     AH = 03h get 386MAX state
  1999.         ES:DI -> 90-byte buffer for state (see #0775)
  2000.         Return: AH = 00h (successful)
  2001.             buffer filled
  2002.     AH = 04h get memory types???
  2003.         ES:DI -> buffer for memory type info (array of bytes, one per
  2004.             16K page) (see #0788)
  2005.         Return:    CX = number of bytes placed in buffer
  2006.     AH = 05h get page table entries
  2007.         AL = A20 control (00h enable A20 first, 01h leave unchanged)
  2008.         CX = buffer size in bytes (0000h = enough for all memory from
  2009.             given start to end of memory managed by 386MAX)
  2010.         SI = first K to report (rounded down to 4K page)
  2011.         ES:DI -> buffer for returned page table entries
  2012.         Return: CX = number of bytes returned (four per 4K page)
  2013.             ES:DI buffer filled
  2014.     AH = 06h get memory speed info
  2015.         ES:DI -> buffer for memory speed records (see #0790)
  2016.         Return: AH = 00h (successful)
  2017.             CX = number of bytes placed in buffer
  2018.         Note:    this function can take over a second to execute
  2019.     AH = 07h map/unmap multiple handle pages
  2020.         DX = EMS handle (on stack)
  2021.         STACK: DWORD -> EMS mapping record
  2022.         Return:    AH = status (00h,80h,83h,8Ah,8Bh)
  2023.         Format of EMS mapping record:
  2024.         Offset    Size    Description
  2025.          00h    WORD    function
  2026.                 0000h use physical page numbers
  2027.                 0001h use segment addresses
  2028.          02h    WORD    EMS handle
  2029.          04h    WORD    number of mapping entries following
  2030.          06h 2N WORDs    logical page number and physical page/segment
  2031.                 logical page FFFFh means unmap physical page
  2032.         SeeAlso: INT 67/AH=50h
  2033.     AH = 08h "EMM2_GOREAL" check whether possible to disable 386MAX
  2034.         AL = ??? (00h or nonzero)
  2035.         Return: AH = status (00h OK, A4h not possible at this time)
  2036.         Note:    if AL=00h, this function always returns success
  2037.     AH = 09h toggle Bit Flags 1 flags
  2038.         BX = bitmask of bit flags 1's flags to toggle (see #0776)
  2039.         Return: AH = 00h (successful)
  2040.         Note:    enables A20 first
  2041.     AH = 0Ah toggle Debugging Flags 1 flags
  2042.         BX = bitmask of Debugging Flags 1's bits to toggle (see #0778)
  2043.         Return: AH = 00h (successful)
  2044.         Notes:    enables A20 first
  2045.             does ??? if bit 3 on after specified bits are toggled
  2046.     AH = 0Bh toggle Debugging Flags 2 flags
  2047.         BX = bitmask of Debugging Flags 2's bits to toggle (see #0779)
  2048.         Return: AH = 00h (successful)
  2049.         Note:    enables A20 first
  2050.     AH = 0Ch toggle feature flags 3
  2051.         BX = bitmask of feature flags 3's bits to toggle (see #0783)
  2052.         Return: AH = 00h (successful)
  2053.         Note:    enables A20 first
  2054.     AH = 0Dh specify 386MAX high-memory location
  2055.         BX = segment address of high-memory real-mode portion of 386MAX
  2056.         CX = current segment of real-mode stub???
  2057.         Return: AH = status (00h successful)
  2058.             ???
  2059.     AH = 0Eh CRT controller register virtualization
  2060.         AL = subfunction
  2061.             00h allow access to CRTC I/O ports 03B4h/03B5h, 03D4h/03D5h
  2062.             01h trap accesses to CRTC I/O ports
  2063.     AH = 0Fh reboot system
  2064.         Return: never
  2065.     AH = 10h unused
  2066.         Return: AH = 84h (unsupported function)
  2067.     AH = 11h get high memory information
  2068.         ES:DI -> 96-byte buffer for high memory info
  2069.         Return: AH = 00h (successful)
  2070.             ES:DI buffer filled
  2071.         Notes:    each byte in buffer contains bit flags for a 4K page in
  2072.               the A000h-FFFFh region
  2073.                 bit 0: page is writeable
  2074.                 bit 1: physical address same as linear address
  2075.                 bit 2: EMS page frame
  2076.                 bit 6: page is part of the QPMS window
  2077.             this function can take over a second to execute,
  2078.               because it does a 128K read for each page in an
  2079.               attempt to flush any RAM cache the system may have
  2080.     AH = 12h shadow RAM mapping
  2081.         AL = subfunction
  2082.             00h unshadow ROMs (except page FFh if NOWARMBOOT set)
  2083.             01h map shadow RAM into ROM regions???
  2084.         Return: AH = 00h (successful) if AL=00h or 01h
  2085.             AH = 8Fh otherwise
  2086.     AH = 13h shadow RAM page protection
  2087.         AL = subfunction
  2088.             00h set all shadowed ROM 4K pages to read-only
  2089.             01h set all shadowed ROM 4K pages to read-write
  2090.         Return: AH = 00h (successful) if AL=00h or 01h
  2091.             AH = 8Fh otherwise
  2092.     AH = 14h get Programmable Option Select info???
  2093.         ES:DI -> 54-byte buffer for POS data???
  2094.         Return: AH = 00h if successful
  2095.             AH = A4h on error
  2096.         Note:    the buffer consists of nine 6-byte fields; the first
  2097.               eight for slots 1-8, the last for the system board
  2098.     AH = 15h ???
  2099.         ???
  2100.         Return: ???
  2101.     AH = 16h get 386MAX memory usage screen
  2102.         ES:DI -> buffer for memory info display
  2103.         CX = size of buffer in bytes
  2104.         Return:    ES:DI buffer filled with '$'-terminated string (if
  2105.                 large enough to hold entire usage screen)
  2106.         Note:    the screen is 0303h bytes in v7.00
  2107.     AH = 17h Windows 3 startup/termination
  2108.         AL = subfunction
  2109.             00h Windows3 initializing
  2110.             DX (on stack) = Windows startup flags
  2111.             DI = Windows version number (major in upper byte)
  2112.             ES:BX = 0000h:0000h
  2113.             DS:SI = 0000h:0000h
  2114.             Return: CX = 0000h if OK for Windows to load
  2115.                    <> 0 if Windows should not load
  2116.                 ES:BX -> startup info structure
  2117.                 DS:SI -> Virtual86 mode enable/disable callback
  2118.             01h Windows3 terminating
  2119.             ES:BX -> ???
  2120.             DX (on stack) = Windows exit flags
  2121.             Return: ???
  2122.     AH = 18h QPMS (Qualitas Protected Memory Services)
  2123.         AL = subfunction
  2124.             00h get QPMS configuration
  2125.             Return: BX = starting segment of QPMS memory window
  2126.                 CX = number of 4K pages reserved for QPMS???
  2127.                 DX = number of 4K pages in QPMS window???
  2128.             01h map QPMS memory page???
  2129.             BX = 4K page number within memory reserved for QPMS???
  2130.             CL = 4K page number within QPMS memory window???
  2131.             02h mark all QPMS memory read-only
  2132.             03h mark all QPMS memory read-write
  2133.         Return: AH = status (00h,8Ah,8Bh,8Fh)
  2134.     AH = 19h get linear address for physical address
  2135.         EDX = physical address (low word on stack)
  2136.         Return: AH = status
  2137.                 00h successful
  2138.                 EDX = linear address at which physical address
  2139.                     may be accessed
  2140.                 8Bh physical address currently not addressable
  2141.         Note:    enables A20 first
  2142.     AH = 1Ah set page table entry
  2143.         EDX = new page table entry (low word on stack)
  2144.         ESI = linear address of page to map (bits 0-11 clear)
  2145.         Return: AH = status (00h,8Bh)
  2146.         Note:    enables A20 first
  2147.     AH = 1Bh get ???
  2148.         Return: AH = status
  2149.             BX = ???
  2150.             CX = number of ???
  2151.             EDX = physical address of ???
  2152.     AH = 1Ch get original interrupt vector
  2153.         AL = interrupt vector (00h-7Fh)
  2154.         Return: AH = 00h (successful)
  2155.             EDX = original vector before 386MAX loaded (segment in
  2156.                 high word, offset in low word)
  2157.         Note:    no range checking is performed; requests for INTs 80h-
  2158.               FFh will return random values
  2159.     AH = 1Dh display string???
  2160.         SI = ???
  2161.         Return: AH = 00h (successful)
  2162.             ???
  2163.         Note:    this function appears to be broken in v7.00
  2164.     AH = 1Eh get memory info
  2165.         ES:DI -> memory info (see #0791)
  2166.         Return: ???
  2167.     AH = 1Fh get DPMI host information
  2168.         Return: AX = 0000h if successful
  2169.             BX = DPMI flags (see #2343 at INT 31/AX=0400h)
  2170.             CL = CPU type (02h = 80286, 03h = 80386, etc.)
  2171.             DX = DPMI ver supported (DH=major, DL=2-digit minor)
  2172.             SI = ???
  2173.             ES???:DI -> ???
  2174.         Note:    NOP if NODPMI switch specified
  2175.     AH = 20h (v7.00) get ???
  2176.         AL = index of ???
  2177.         Return: EDX = ??? for specified ???
  2178.     AH = 21h (v7.00) STACKS support
  2179.         AL = 00h get STACKS parameters
  2180.         Return: BX = ??? (0060h for v7.00)
  2181.             CX = number of stacks for hardware interrupts
  2182.             DX = size of each stack in bytes
  2183.             SI = ??? (low and high bytes are separate values)
  2184.             DI = ??? (low and high bytes are separate values)
  2185.                 low byte = logical page number set by subfn 02h
  2186.             ES = ???
  2187.         AL = 01h set ??? "EMM2_DSTKS"
  2188.         EBX = ???
  2189.         ECX = ???
  2190.         AL = 02h set ???
  2191.         BL = logical page number for ??? (00h-03h)
  2192.         Return: AH = status (00h,8Ah)
  2193.     AH = 22h (v7.00) call ??? for every load module
  2194.         AL = which function to call
  2195.         00h call ???
  2196.         else call ????
  2197.         Return: AH = 00h
  2198.         Note: if AL=00h, calls the protected-mode function pointed at by
  2199.         the DWORD at offset 22h from the start of each module installed
  2200.         by a LOAD= directive; if AL<>00h, it calls the function
  2201.         pointed at by the DWORD at offset 28h of the load module
  2202.     AH = 23h (v7.00) ???
  2203.         AL = 00h set ???
  2204.         BL = ???
  2205.         Return:    AH = 00h or unchanged (depending on ???)
  2206.         AL = 01h set ???
  2207.         BL = ???
  2208.         BH = ???
  2209.         CX = ???
  2210.         DX = ??? (on top of stack)
  2211.         Return: AH = status (00h if successful, 8Fh once table full)
  2212.         Note:    this call adds one entry to an internal table on each
  2213.               call, until the table is full
  2214.         AL = 02h get ???
  2215.         CX = size of buffer
  2216.         ES:DI -> buffer for ??? (60 bytes total data)
  2217.         Return: CX = number of bytes actually returned
  2218.         Note:    returns the array storing the values set with AX=2301h
  2219.         Format of one entry in array:
  2220.         Offset    Size    Description
  2221.          00h    BYTE    ??? (BL from subfn 01h)
  2222.          01h    WORD    ??? (CX from subfn 01h)
  2223.          03h    BYTE    ??? (BH from subfn 01h)
  2224.          04h    WORD    ??? (DX from subfn 01h)
  2225.         AL = 03h set ??? name/path
  2226.         ES:DI -> buffer containing ASCIZ ???
  2227.         AL = 04h get ???
  2228.         ES:DI -> buffer for ASCIZ ???
  2229.         Note: the ASCIZ string for subfunctions 03h and 04h does not appear
  2230.         to be used by 386MAX, and may serve merely for communication
  2231.         between two other Qualitas programs
  2232.     AH = 24h (v7.00) high memory control
  2233.         AL = 00h get high memory state
  2234.         Return: BX = current state
  2235.                 00h high memory removed from DOS memory chain
  2236.                 01h high memory included in DOS memory chain
  2237.         AL = 01h set high memory state
  2238.         BX = new state
  2239.             00h high memory removed from DOS memory chain
  2240.             01h high memory included in DOS memory chain
  2241.             else
  2242.             Return: ??? (error, but return varies according to ???)
  2243.     AH = 25h (v7.00) remove high RAM from DOS memory chain
  2244.     AH = 26h (v7.00) ???
  2245.         BX = ???
  2246.         CX = ???
  2247.         SI = ???
  2248.         DI = ???
  2249.         Return: AH = status
  2250.             BX = ???
  2251.             CX = ???
  2252.     AH = 27h (v7.00) ???
  2253.         AL = 00h get ???
  2254.         Return: BX = number of paragraphs for ???
  2255.         AL = 01h ???
  2256.         BX = ???
  2257.         ES??? = ???
  2258.         AL = 02h ???
  2259.         ???
  2260.         AL = 03h ???
  2261.         CX = ???
  2262.         DX = ???
  2263.         ES??? = ???
  2264.         Return: ???
  2265.     AH = 28h (v7.00) get ???
  2266.         Return: AH = status (00h,8Fh) (see #2822 at INT 67/AH=40h)
  2267.             if AH=00h,
  2268.                 CX = ???
  2269.                 DX = ???
  2270.     AH = 29h (v7.00) get ???
  2271.         Return: AX = ???
  2272.     AH = 40h-5Dh EMS services (see INT 67/AH=40h etc)
  2273.     AH = DEh VCPI services (see INT 67/AX=DE00h etc)
  2274. Return: AH = status (as for EMS INT 67 calls)
  2275.         00h successful
  2276.         80h internal error
  2277.         81h hardware malfunction
  2278.         83h invalid handle
  2279.         84h    undefined function
  2280.         8Ah invalid logical page nuber
  2281.         8Bh illegal physical page number
  2282.         8Fh undefined subfunction
  2283.         A4h access denied
  2284.         etc.
  2285.     STACK popped (value placed in DX if no specific return value for DX)
  2286.  
  2287. Format of 386MAX memory speed record:
  2288. Offset    Size    Description    (Table 0790)
  2289.  00h    DWORD    page table entry for 4K page
  2290.  04h    WORD    number of microticks (840ns units) required for REP LODSD of
  2291.           entire 4K page
  2292.  
  2293. Format of 386MAX memory info [array]:
  2294. Offset    Size    Description    (Table 0791)
  2295.  00h    DWORD    linear start address
  2296.  04h    DWORD    size in bytes
  2297.  08h    WORD    XMS handle (if next byte = 04h)
  2298.         ??? (if next byte = 05h)
  2299.         ??? (if next byte = 06h)
  2300.         ??? (if next byte = 13h)
  2301.         ??? (if next byte = 14h)
  2302.         ??? (if next byte = 15h)
  2303.         ??? (if next byte = 23h)
  2304.         ??? (if next byte = 24h)
  2305.         ??? (if next byte = 26h)
  2306.         else unused
  2307.  0Ah    BYTE    type
  2308.         00h = ???, 01h = VDISK,
  2309.         02h = INT 15h extended memory, 03h = ??? extended,
  2310.         04h = XMS handle's memory, 05h = ???, 06h = ???, 07h = ???,
  2311.         08h = ???, 09h = ???, 0Ah = ???, 0Bh = ???,
  2312.         11h = ???, 12h = ???, 14h = ???, 15h = ???,
  2313.         19h = ???, 1Ah = ???, 1Bh = ???,
  2314.         1Ch = ???, 1Dh = ???, 1Eh = ???, 1Fh = ???,
  2315.         20h = ???, 21h = ???, 23h = ???, 24h = ???,
  2316.         26h = ???
  2317.  0Bh    BYTE    ??? (00h for types 00h-03h, 07h-0Bh, 19h-21h;
  2318.              80h for types 04h/13h-15h/23h-26h;
  2319.             ??? for type 05h)
  2320. --------V-214402-----------------------------
  2321. INT 21 - PGS1600.DEV - IOCTL - GET CONFIGURATION INFO
  2322.     AX = 4402h
  2323.     BX = file handle for device "PGS1600$"
  2324.     CX = 0018h (size of buffer)
  2325.     DS:DX -> configuration buffer (see #0792)
  2326. Return: CF clear if successful
  2327.         buffer filled
  2328.         AX = number of bytes actually copied
  2329.     CF set on error
  2330.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2331. Program: PGS1600.DEV is a device driver for the Cornerstone Technology PG1600
  2332.       display adapter, which provides a 1600x1200 monochrome display as
  2333.       well as one of two emulations, MDA or CGA.
  2334. SeeAlso: AX=4403h"PGS1600"
  2335.  
  2336. Format of PGS1600.DEV configuration information:
  2337. Offset    Size    Description    (Table 0792)
  2338.  00h    WORD    version (high byte = major, low byte = minor)
  2339.  02h    WORD    board initialisation mode
  2340.  04h    WORD    board I/O address
  2341.         03D0h CGA emulation
  2342.         03B0h MDA emulation
  2343.         0390h no emulation
  2344.         0350h no emulation, alternate
  2345.  06h    WORD    emulation buffer segment
  2346.         B800h    CGA emulation
  2347.         B000h    MDA emulation
  2348.         0000h    no emulation
  2349.  08h    WORD    PG1600 graphics buffer segment
  2350.  0Ah    WORD    number of bytes between consecutive graphic rows
  2351.  0Ch    WORD    horizontal pixel size
  2352.  0Eh    WORD    vertical pixel size
  2353.  10h    WORD    horizontal dots per inch
  2354.  12h    WORD    vertical dots per inch
  2355.  14h    WORD    graphics buffer bits per pixel
  2356.  16h    WORD    monitor bits per pixel
  2357. --------N-214402-----------------------------
  2358. INT 21 - PC/TCP IPCUST.SYS - RESET CONFIGURATION DATA READ POINTER
  2359.     AX = 4402h
  2360.     BX = file handle referencing device "$IPCUST"
  2361.     CX, DS:DX ignored
  2362. Return: CF clear if successful
  2363.         AX destroyed
  2364.     CF set on error
  2365.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2366. Notes:    there are a total of 378h bytes of configuration data for IPCUST.SYS
  2367.       version 2.05.     If less than the entire data is read or written,
  2368.       the next read/write continues where the previous one ended; this
  2369.       call and AX=4403h both reset the location at which the next
  2370.       operation starts to zero
  2371.     v2.1+ uses a new configuration method, but allows the installation
  2372.       of IPCUST.SYS for backward compatibility with other software which
  2373.       must read the PC/TCP configuration
  2374. SeeAlso: AH=3Fh"IPCUST",AH=40h"IPCUST",AX=4403h"IPCUST"
  2375. --------N-214402-----------------------------
  2376. INT 21 - WORKGRP.SYS - GET API ENTRY POINT
  2377.     AX = 4402h
  2378.     BX = file handle for device "NET$HLP$"
  2379.     CX = 0008h
  2380.     DS:DX -> buffer for entry point record (see #0793)
  2381. Return: CF clear if successful
  2382.         AX = number of bytes actually read
  2383.     CF set on error
  2384.         AX = error code
  2385. Program: WORKGRP.SYS is the portion of Microsoft's Workgroup Connection which
  2386.       permits communication with PCs running Windows for Workgroups or
  2387.       LAN Manager
  2388. SeeAlso: AH=3Fh"WORKGRP.SYS"
  2389.  
  2390. Format of WORKGRP.SYS entry point record:
  2391. Offset    Size    Description    (Table 0793)
  2392.  00h    WORD    3633h  \ signature???
  2393.  02h    WORD    EF6Fh  /
  2394.  04h    DWORD    address of entry point (see #0794)
  2395. Note:    first four bytes of buffer must be 6Fh E9h 33h 36h on entry when using
  2396.       IOCTL rather than READ to get the entry point record
  2397.  
  2398. (Table 0794)
  2399. Call WORKGRP entry point with:
  2400.     STACK:    WORD    function number (0000h-0009h)
  2401. Return: STACK unchanged
  2402. SeeAlso: #0795,#0796,#0797,#0798,#0799,#0800,#0801,#0802
  2403.  
  2404. (Table 0795)
  2405. Call WORKGRP function 00h with:
  2406.     STACK:    WORD    0000h (function "get ???")
  2407. Return: DX:AX -> data table
  2408.  
  2409. (Table 0796)
  2410. Call WORKGRP function 01h with:
  2411.     STACK:    WORD    0001h (function "hook ???")
  2412. Return: STACK:    DWORD    pointer to ???
  2413.         WORD    0001h (function number)
  2414.  
  2415. (Table 0797)
  2416. Call WORKGRP function 02h with:
  2417.     STACK:    WORD    0002h (function "unhook ???")
  2418.     ???
  2419. Return: ???
  2420.  
  2421. (Table 0798)
  2422. Call WORKGRP function 03h with:
  2423.     STACK:    WORD    0003h (function "reenable printer port")
  2424.         WORD    LPT port number
  2425. Return: ???
  2426.  
  2427. (Table 0799)
  2428. Call WORKGRP function 04h with:
  2429.     STACK:    WORD    0004h (function "disable printer port")
  2430.         WORD    LPT port number
  2431. Return: ???
  2432.  
  2433. (Table 0800)
  2434. Call WORKGRP function 05h with:
  2435.     STACK:    WORD    0005h (function "???")
  2436.         ???
  2437. Return: ???
  2438.  
  2439. (Table 0801)
  2440. Call WORKGRP function 06h with:
  2441.     STACK:    WORD    0006h (function "???")
  2442. Return: STACK unchanged
  2443.     AX = 0000h
  2444.     DX = 0000h
  2445.  
  2446. (Table 0802)
  2447. Call WORKGRP functions 07h-09h with:
  2448.     STACK:    WORD    0007h-0009h (NOP functions)
  2449. Return: STACK unchanged
  2450.     AX = 0001h
  2451.     DX = 0000h
  2452. --------N-214402-----------------------------
  2453. INT 21 - 10NET v5.0 - 10BEUI.DOS - API
  2454.     AX = 4402h
  2455.     BX = file handle referencing device "10BEUI$"
  2456.     DS:DX -> parameter record (see #0803)
  2457.     CX ignored
  2458. Return: CF clear if successful
  2459.         AX destroyed
  2460.     CF set on error
  2461.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2462. SeeAlso: AX=4402h"10MEMMGR",INT 6F/AH=00h"10NET"
  2463.  
  2464. Format of 10NET 10BEUI.DOS parameter record:
  2465. Offset    Size    Description    (Table 0803)
  2466.  00h    WORD    000Ah (function number???)
  2467.  02h    WORD    ???
  2468.  04h    DWORD    pointer to buffer for ???
  2469.  08h  4 BYTEs    ???
  2470.  0Ch    WORD    transfer size
  2471. --------N-214402-----------------------------
  2472. INT 21 - 10NET v5.0 - 10MEMMGR.SYS - API
  2473.     AX = 4402h
  2474.     BX = file handle referencing device "MEMMGR0$"
  2475.     DS:DX -> 6-byte buffer for interface info (see #0804)
  2476.     CX ignored
  2477. Return: CF clear if successful
  2478.         AX destroyed
  2479.     CF set on error
  2480.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2481. SeeAlso: AX=4402h"10BEUI",INT 6F/AH=00h"10NET"
  2482.  
  2483. Format of 10NET 10MEMMGR.SYS interface info:
  2484. Offset    Size    Description    (Table 0804)
  2485.  00h    DWORD    address of entry point (see #0805)
  2486.  04h    WORD    version (0500h for v5.00)
  2487.  
  2488. (Table 0805)
  2489. Call 10NET 10MEMMGR.SYS entry point with:
  2490.     AL = 01h ???
  2491.         BX = ???
  2492.         Return: CF clear if successful
  2493.             CF set on error
  2494.             AX = error code
  2495.     AL = 02h ???
  2496.         ???
  2497.     AL = 03h ???
  2498.         ???
  2499.     AL = 04h set/restore memory allocation strategy
  2500.         BX = subfunction
  2501.         0000h set strategy
  2502.         0001h restore strategy
  2503.         Return: CF clear if successful
  2504.             CF set on error (if function disabled)
  2505.             various registers destroyed
  2506.     AL = other
  2507.         Return: CF set
  2508.             AX = 0000h
  2509.             BL = 01h
  2510. --------V-214402-----------------------------
  2511. INT 21 - Compaq AG1024.SYS - RGDI - GET DRIVER LOCATION
  2512.     AX = 4402h
  2513.     BX = file handle for device "$$$$RGDI"
  2514.     CX = 0006h (size of returned data)
  2515.     DS:DX -> location record (see #0806)
  2516. Return: CF clear if successful
  2517.         buffer filled
  2518.     CF set on error
  2519.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2520. Program: AG1024.SYS is a device driver for the Advanced Graphics 1024 adapter
  2521. SeeAlso: AX=4403h"RGDI"
  2522.  
  2523. Format of Compaq AG1024.SYS location record:
  2524. Offset    Size    Description    (Table 0806)
  2525.  00h    WORD    signature 55AAh
  2526.  02h    WORD    segment of ???
  2527.  04h    WORD    segment of device driver's code
  2528. --------N-214402-----------------------------
  2529. INT 21 - FTPSOFT.DOS v3.1 - GET ???
  2530.     AX = 4402h
  2531.     BX = file handle for device "FTPSOFT$"
  2532.     CX = size of buffer
  2533.     DS:DX -> buffer for data (see #0807)
  2534. Return: CF clear if successful
  2535.         buffer filled
  2536.     CF set on error
  2537.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2538. Program: FTPSOFT.DOS is a device driver for Protocol Manager support from
  2539.        FTP Software, Inc.
  2540. SeeAlso: AH=3Fh"PC/TCP",AX=4402h"NDIS"
  2541.  
  2542. Format of FTPSOFT.DOS data:
  2543. Offset    Size    Description    (Table 0807)
  2544.  00h    WORD    (call) BA98h (if different, no data returned)
  2545.  02h    DWORD    -> NDIS common characteristics table
  2546.           (see #0746 at AX=4402h"NDIS")
  2547.  06h    DWORD    (call) -> new dispatch table (see #0748 at AX=4402h"NDIS")
  2548.  0Ah    DWORD    -> 28-byte buffer for ??? data
  2549.  0Eh    DWORD    ???
  2550.  12h    DWORD    -> FAR function to reset dispatch jump table to defaults
  2551.  16h    BYTE    ???
  2552. Note:    the addresses in the new dispatch table are copied into an internal
  2553.       jump table which may be reset by calling the function pointed at by
  2554.       offset 12h
  2555. --------n-214402-----------------------------
  2556. INT 21 U - PenDOS PENDEV.SYS - GET ENTRY POINTS
  2557.     AX = 4402h
  2558.     BX = file handle for device "$$PENDOS" or "$$PD_REG"
  2559.     CX = size of buffer (4 for $$PENDOS and a 4,8,12, or 16 for $$PD_REG)
  2560.     DS:DX -> buffer for entry point record (see #0808)
  2561. Return: CF clear if successful
  2562.         buffer filled
  2563.     CF set on error
  2564.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2565. Program: A limited version of PenDOS by Communication Intelligence Corporation,
  2566.       which provides pen capability to keyboard-based programs, is bundled
  2567.       with IBM DOS 6.1
  2568. SeeAlso: AX=4403h"PENDEV.SYS"
  2569.  
  2570. Format of PENDEV.SYS entry point record:
  2571. Offset    Size    Description    (Table 0808)
  2572.  00h    DWORD    -> array of jumps
  2573.  04h    WORD    offset of function to retrieve entry point (see #0809)
  2574.  06h  2 BYTEs    signature "Pe"
  2575.  08h    WORD    offset of function to set entry point (see #0810)
  2576.  0Ah  2 BYTEs    signature "nD"
  2577.  0Ch    WORD    offset of function to clear entry point (see #0811)
  2578.  0Eh    WORD    signature "OS"
  2579.  
  2580. (Table 0809)
  2581. Call PENDEV.SYS function to retrieve entry point with:
  2582.     AX = index of entry point (0-9)
  2583. Return: CF clear if successful
  2584.         DX:AX -> desired entry point
  2585.     CF set on error (AX out of range)
  2586.  
  2587. (Table 0810)
  2588. Call PENDEV.SYS function to set entry point with:
  2589.     AX = index of entry point (0-9)
  2590.     DX:SI -> new handler
  2591. Return: CF clear if successful
  2592.     CF set on error (AX out of range)
  2593.  
  2594. (Table 0811)
  2595. Call PENDEV.SYS function to clear entry point with:
  2596.     AX = index of entry point (0-9)
  2597. Return: CF clear if successful
  2598.     CF set on error (AX out of range)
  2599. Note:    resets the jump at the specified entry point to its default target,
  2600.       which simply returns
  2601. --------N-214402-----------------------------
  2602. INT 21 U - LAN Manager - TCPDRV.DOS - API
  2603.     AX = 4402h
  2604.     BX = file handle referencing device "TCPDRV$"
  2605.     CX = 0019h
  2606.     DS:DX -> buffer containing request block (see #0812)
  2607. Return: CF clear if successful
  2608.         buffer filled
  2609.     CF set on error
  2610.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2611. Program: TCPDRV.DOS is the low-level device driver supporting LAN Manager's
  2612.       TCP/IP protocol stack
  2613.  
  2614. Format of TCPDRV.DOS request block:
  2615. Offset    Size    Description    (Table 0812)
  2616.  00h    BYTE    (call) function number
  2617.         00h initialize ???
  2618.         06h get ???
  2619.         07h get ???
  2620.  01h    BYTE    (call) 00h
  2621.         (ret) error code if error, unchanged if successful
  2622.  02h    WORD    signature 4354h ('CT')
  2623. ---function 00h---
  2624.  04h    DWORD    (call) pointer to ??? FAR function
  2625.         function is called with ES:BX -> device driver request used to
  2626.           invoke this function
  2627.  08h  4 BYTEs    ???
  2628.  0Ch    DWORD    (call) pointer to ??? record, WORD at offset 22h is read
  2629.  10h    DWORD    (ret) -> ??? buffer if 0000h:0000h on call
  2630. ---function 06h---
  2631.  04h  4 BYTEs    ???
  2632.  08h    DWORD    (ret) pointer to ???
  2633. ---function 07h---
  2634.  04h    DWORD    (ret) pointer to ??? record
  2635. --------y-214402-----------------------------
  2636. INT 21 U - PC Tools 9 CPRLOW.EXE - GET CODE AND DATA ADDRESSES
  2637.     AX = 4402h
  2638.     BX = file handle referencing device "RECLOWLD"
  2639.     DS:DX -> buffer for address list (see #0813)
  2640.     CX ignored
  2641. Return: CF clear if successful
  2642.         buffer filled
  2643.     CF set on error
  2644.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2645.  
  2646. Format of CPRLOW address list:
  2647. Offset    Size    Description    (Table 0813)
  2648.  00h    WORD    segment of CPRLOW code
  2649.  02h    WORD    offset in code segment of ??? entry point
  2650.         (switches into protected mode)
  2651.  04h    WORD    offset in code segment of jump array (see #0814)
  2652.  06h    WORD    segment of copy of interrupt vector table at CPRLOW load time
  2653. Note:    neither the entry point nor the jump array is valid until after a
  2654.       CPR /LOAD, because CPR.EXE installs the code into CPRLOW at runtime.
  2655.  
  2656. Format of CPRLOW jump array:
  2657. Offset    Size    Description    (Table 0814)
  2658.  00h  3 BYTEs    initialize CPRLOW interrupt hooks
  2659.  03h  3 BYTEs    reset timers and enable CPR (hotkey enable)
  2660.  06h  3 BYTEs    disable CPR (hotkey disable)
  2661.  09h  3 BYTEs    clear ??? flag, hotkey disable, and ???
  2662.  0Ch  3 BYTEs    initialize delay loop counter (destroys AX,BX,CX,DX)
  2663.  0Fh  3 BYTEs    disable CPR completely (commandline /DISABLE)
  2664.  12h  3 BYTEs    enable ??? if CPR enabled by both cmdline and hotkey
  2665.  15h  3 BYTEs    enable CPR (commandline /ENABLE)
  2666. --------s-214402-----------------------------
  2667. INT 21 U - Creative Technology CTMMSYS.SYS v1.00.01 - API
  2668.     AX = 4402h
  2669.     BX = file handle for device "CTMMSYS$"
  2670.     CX = 0004h (size of data)
  2671.     DS:DX -> buffer for entry point (see #0815)
  2672. Return: CF clear if successful
  2673.         buffer updated
  2674.     CF set on error
  2675.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2676. Program: CTMMSYS.SYS is the Creative DOS Multimedia Architecture Integration
  2677.       driver
  2678. SeeAlso: AX=4402h"CTSB2",INT 80/BX=0000h"SBFM"
  2679.  
  2680. Format of CTMMSYS.SYS entry point record:
  2681. Offset    Size    Description    (Table 0815)
  2682.  00h    DWORD    (call) signature 4D6D7443h (ASCII "CtmM")
  2683.         (ret) pointer to CTMMSYS entry point (see #0816)
  2684. SeeAlso: #0817
  2685.  
  2686. (Table 0816)
  2687. Call CTMMSYS.SYS entry point with:
  2688.     AX = ???
  2689.     STACK:    WORD    ???
  2690.         WORD    ???
  2691.         WORD    ??? (0001h,0002h,0005h,0006h)
  2692.         WORD    ???
  2693.         DWORD    -> ???
  2694.         WORD    ???
  2695.         WORD    ???
  2696. Return: DX:AX = ??? or error code
  2697.         0000h:000Bh invalid value for ???
  2698.         0000h:000Fh API call already in progress
  2699. SeeAlso: #0815
  2700. --------s-214402-----------------------------
  2701. INT 21 U - Creative Technology CTSB2.SYS v1.01.01 - API
  2702.     AX = 4402h
  2703.     BX = file handle for device "CTSOUND0"
  2704.     CX = 0004h (size of data)
  2705.     DS:DX -> buffer for entry point (see #0817)
  2706. Return: CF clear if successful
  2707.         buffer updated
  2708.     CF set on error
  2709.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2710. Program: CTMMSYS.SYS is the Creative DOS Multimedia Architecture Integration
  2711.       driver
  2712. SeeAlso: AX=4402h"CTMMSYS",INT 80/BX=0000h"SBFM"
  2713.  
  2714. Format of CTSB2.SYS entry point record:
  2715. Offset    Size    Description    (Table 0817)
  2716.  00h    DWORD    (call) signature 4D6D7443h (ASCII "CtmM")
  2717.         (ret) pointer to CTSB2 entry point (see #0818)
  2718. SeeAlso: #0815
  2719.  
  2720. (Table 0818)
  2721. Call CTSB2.SYS entry point with:
  2722.     AX = ???
  2723.     STACK:    DWORD    -> ???
  2724.         WORD    function number
  2725.             (0100h,0200h,0300h,0400h,0500h,0600h,0701h)
  2726.         DWORD    -> ???
  2727.         WORD    ???
  2728.         WORD    ???
  2729. Return: DX:AX = ??? or error code
  2730.         0000h:0004h invalid subfunction???
  2731.         0000h:000Bh invalid value for ???
  2732.         0000h:000Fh API call already in progress
  2733. SeeAlso: #0817
  2734. --------m-214402-----------------------------
  2735. INT 21 U - Novell DOS 7 EMM386.EXE - GET STATE RECORD???
  2736.     AX = 4402h
  2737.     BX = file handle for device "EMMXXXX0"
  2738.     CX = 003Eh (size of state record)
  2739.     DS:DX -> buffer for state record (see #0819)
  2740. Return: CF clear if successful
  2741.         buffer filled (see #2777 at INT 67/AH=3Fh)
  2742.     CF set on error
  2743.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2744.  
  2745. Format of Novell DOS 7 EMM386.EXE state record:
  2746. Offset    Size    Description    (Table 0819)
  2747.  00h    WORD    signature EDC0h
  2748.  02h 60 BYTEs    ???
  2749. --------m-214402SF00-------------------------
  2750. INT 21 U - Memory Managers - GET API ENTRY POINT
  2751.     AX = 4402h subfn 00h
  2752.     BX = file handle for device "EMMXXXX0"
  2753.     CX = 0006h (size of buffer in bytes)
  2754.     DS:DX -> buffer for API entry point record (see #0820)
  2755.         first byte must be 00h on entry
  2756. Return: CF clear if successful
  2757.         buffer filled (see #2777 at INT 67/AH=3Fh)
  2758.     CF set on error
  2759.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2760. Notes:    this function is supported by Microsoft EMM386.EXE v4.45+ and
  2761.       CEMM v5.10+, and is intended for use by MS Windows as it starts up
  2762.     if no other program has hooked INT 67, an alternate installation
  2763.       check for CEMM is testing for the string
  2764.       "COMPAQ EXPANDED MEMORY MANAGER 386" at offset 14h in the INT 67
  2765.       handler's segment; if present, the word at offset 12h contains the
  2766.       offset of the API entry point
  2767. SeeAlso: AX=4402h/SF=01h,AX=4402h/SF=02h,AX=4402h"EMM386",INT 67/AH=3Fh
  2768.  
  2769. Format of memory manager API entry point record:
  2770. Offset    Size    Description    (Table 0820)
  2771.  00h    WORD    ??? (0022h for CEMM 5.11, 0025h for MS EMM386 v4.45)
  2772.  02h    DWORD    manager's private API entry point
  2773.         (see #0821,#2840 at INT 67/AX=FFA5h)
  2774.  
  2775. (Table 0821)
  2776. Call CEMM v5.10+ entry point with:
  2777.     AH = 00h get memory manager's state
  2778.         Return: AH = state
  2779.             bit 0: turned OFF
  2780.             bit 1: AUTO mode enabled
  2781.     AH = 01h set memory manager's state
  2782.         AL = new state (00h ON, 01h OFF, 02h AUTO)
  2783.         Return: CF clear if successful
  2784.             CF set on error
  2785.     AH = 02h Weitek coprocessor support
  2786.         AL = subfunction
  2787.         00h get Weitek support state
  2788.             Return: AL = status
  2789.                 bit 0: Weitek coprocessor is present
  2790.                 bit 1: Weitek support is enabled
  2791.         01h turn on Weitek support
  2792.         02h turn off Weitek support
  2793.         Return: CF clear if successful
  2794.             CF set on error
  2795.             AH = error code (01h invalid subfunc, 02h no Weitek)
  2796.     AH = 05h get statistics
  2797.         ???
  2798.     AH > 06h
  2799.         Return: CF set
  2800.             AH = 01h (invalid function)
  2801. Notes:    AH=03h,04h,06h are NOPs which return CF clear, presumably for backwards
  2802.       compatibility with earlier versions of CEMM
  2803.     in v5.11, AH=05h merely prints an error message (using INT 21/AH=09h)
  2804.       stating that a different version of CEMM is installed and it is
  2805.       therefore not possible to display the statistics
  2806. --------m-214402SF01-------------------------
  2807. INT 21 U - Memory Managers - GET EMM IMPORT STRUCTURE ADDRESS
  2808.     AX = 4402h subfn 01h
  2809.     BX = file handle for device "EMMXXXX0"
  2810.     CX = 0006h (size of buffer in bytes)
  2811.     DS:DX -> buffer for EMM import structure record (see #0822)
  2812.         first byte must be 01h on entry
  2813. Return: CF clear if successful
  2814.         buffer filled (see also #2777 at INT 67/AH=3Fh)
  2815.     CF set on error
  2816.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2817. Notes:    this function is supported by Microsoft EMM386.EXE v4.45+,
  2818.       QEMM-386 v6+, and CEMM v5.10+, and is intended for use by MS Windows
  2819.       as it starts up
  2820.     for QEMM-386, this call always returns an error if Windows3 support
  2821.       has been disabled with the NW3 switch
  2822. SeeAlso: AX=4402h/SF=00h,AX=4402h"EMM386",INT 2F/AX=D201h/BX=5145h
  2823. SeeAlso: INT 67/AH=3Fh
  2824.  
  2825. Format of EMM import structure record:
  2826. Offset    Size    Description    (Table 0822)
  2827.  00h    DWORD    physical address of EMM import structure (see #0823)
  2828.  04h    BYTE    EMM import structure major version
  2829.  05h    BYTE    EMM import structure minor version
  2830. Note:    version 1.00 contains only EMS information (Windows 3.0+)
  2831.     version 1.10 contains UMB/XMS/HMA/EMS information (Windows 3.1)
  2832.     version 1.11 is version 1.10 plus memory manager maker/product name
  2833. SeeAlso: #2817
  2834.  
  2835. Format of Global EMM Import record:
  2836. Offset    Size    Description    (Table 0823)
  2837.  00h    BYTE    bit flags
  2838.         bit 2: ???
  2839.         bit 3: free EMM386 virtual HMA only if hma_page_table_paddr!=0
  2840.         bit 4: no UMB???
  2841.  01h    BYTE    reserved (0)
  2842.  02h    WORD    size of structure in bytes
  2843.  04h    WORD    structure version
  2844.  06h    DWORD    reserved
  2845.  0Ah 384 BYTEs    64 EMS frame status records (see #0824), one per 16K of
  2846.           real-mode 1M address space
  2847. 18Ah    BYTE    ??? (must be at least 3*number_of_EMS_frames+4)
  2848. 18Bh    BYTE    number of UMB frame descriptors following
  2849. 18Ch 4N DWORDs    UMB frame descriptors
  2850.         each is 4 DWORDs giving physical page numbers for the four
  2851.           4K pages of a 16K EMS frame (00000000h if non-UMB page)
  2852. var    BYTE    number of EMS handle info records following
  2853.     16N BYTEs    EMS handle info records (see #0826)
  2854. ---version 1.10+ ---
  2855.     DWORD    realmode INT 67 vector (used by Windows to set breakpoints)
  2856.     DWORD    physical address of HMA page table values
  2857.     BYTE    number of free page entries following
  2858.      2N DWORDs    free page entries
  2859.         each is:
  2860.             DWORD    physical page number
  2861.             DWORD    number of consecutive physical pages
  2862.     BYTE    number of XMS handle info records following
  2863.         00h if memory manager does not emulate XMS or has real mode
  2864.           XMS code which can execute in the Windows environment
  2865.     12N BYTEs    XMS handle info records (see #0827)
  2866.     BYTE    number of free UMB info records following
  2867.      2N WORDs    free UMB info records
  2868.         each is:
  2869.             WORD    real mode start segment
  2870.             WORD    size in paragraphs
  2871. ---version 1.11---
  2872.      20 BYTEs    blank-padded maker name
  2873.      20 BYTEs    blank-padded product name
  2874.  
  2875. Format of EMS frame status record:
  2876. Offset    Size    Description    (Table 0824)
  2877.  00h    BYTE    frame type (see #0825)
  2878.  01h    BYTE    owner handle (00h/FFh = none) from frame including UMB
  2879.         index to UMB frame descriptors
  2880.  02h    WORD    logical page for frame, 7FFFh if none, FFFFh if non-EMS frame
  2881.  04h    BYTE    EMS physical page number (FFh for non-EMS = don't care???)
  2882.  05h    BYTE    flags for non-EMS frames (00h for EMS frame)
  2883.         bits 0,1 for first 4K, bits 2,3 for second 4K, etc:
  2884.           10: direct mapping (linear address = physical address)
  2885.           01: UMB mapping
  2886.  
  2887. Bitfields for EMS frame type:
  2888. Bit(s)    Description    (Table 0825)
  2889.  0    EMS frame
  2890.  1    (if EMS frame) in standard 64K page frame
  2891.  2    first 4K of frame is UMB
  2892.  3    second 4K of frame is UMB
  2893.  4    third 4K of frame is UMB
  2894.  5    last 4K of frame is UMB
  2895.  
  2896. Format of EMS handle info record:
  2897. Offset    Size    Description    (Table 0826)
  2898.  00h    BYTE    handle number (00h = system handle)
  2899.  01h    BYTE    flags
  2900.         bit 0: normal handle rather than system handle
  2901.         bit 2: ??? (set by some EMS managers)
  2902.  02h  8 BYTEs    EMS handle's name
  2903.  0Ah    WORD    number of 16K pages for handle
  2904.  0Ch    DWORD    physical address of page table entries forming page map
  2905. Note:    all values should be zero for the system handle if no large frame
  2906.       support is present
  2907.  
  2908. Format of XMS handle info record:
  2909. Offset    Size    Description    (Table 0827)
  2910.  00h    WORD    handle
  2911.  02h    WORD    flags
  2912.         bit 0: handle usable by Windows
  2913.             (already in use when Windows started if clear)
  2914.         bit 1: reserved (0)
  2915.  04h    DWORD    size in KB (may be zero, used only if flags bit 0 set)
  2916.  08h    DWORD    physical address (only if flags bit 0 set)
  2917. --------m-214402SF02-------------------------
  2918. INT 21 U - Memory Managers - GET MEMORY MANAGER VERSION
  2919.     AX = 4402h subfn 02h
  2920.     BX = file handle for device "EMMXXXX0"
  2921.     CX = 0002h (size of buffer in bytes)
  2922.     DS:DX -> buffer for memory manager version (see #0828)
  2923.         first byte must be 02h on entry
  2924. Return: CF clear if successful
  2925.         buffer filled
  2926.     CF set on error
  2927.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2928. Note:    this function is supported by Microsoft EMM386.EXE v4.45+ and
  2929.       CEMM v5.10+, and is intended for use by MS Windows as it starts up
  2930. SeeAlso: AX=4402h/SF=00h,AX=4402h"EMM386",INT 67/AH=3Fh
  2931.  
  2932. Format of memory manager version:
  2933. Offset    Size    Description    (Table 0828)
  2934.  00h    BYTE    major version
  2935.  01h    BYTE    minor version (binary)
  2936. --------m-214402-----------------------------
  2937. INT 21 U - Microsoft EMM386.EXE v4.45 - GET MEMORY MANAGER INFORMATION
  2938.     AX = 4402h
  2939.     BX = file handle for device "EMMXXXX0"
  2940.     CX = size of buffer in bytes (varies, see #0829)
  2941.     DS:DX -> buffer for returned data (see #0829)
  2942.         first byte must be set on entry to indicate desired data
  2943. Return: CF clear if successful
  2944.         buffer filled
  2945.     CF set on error
  2946.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2947. Notes:    an error is returned if the number of bytes to be read does not match
  2948.       the number of bytes returned for the specified data item
  2949.     this function is part of the interface which allows MS Windows to
  2950.       cooperate with memory managers
  2951. SeeAlso: AX=4402h/SF=00h,AX=4402h/SF=01h,AX=4402h/SF=02h,INT 67/AX=FFA5h
  2952.  
  2953. Format of EMM386.EXE data buffer:
  2954. Offset    Size    Description    (Table 0829)
  2955.  00h    BYTE    (call) function
  2956.         03h get ???
  2957.         04h get ???
  2958. ---function 03h---
  2959.  00h    WORD    ???
  2960.  02h    WORD    ???
  2961. ---function 04h---
  2962.  00h    WORD    segment of UMB containing EMM386 code/data
  2963.  02h    WORD    number of paragraphs of EMM386 code/data in UMB
  2964.  04h    WORD    ???
  2965. ----------214402-----------------------------
  2966. INT 21 U - IFSHLP.SYS - GET ENTRY POINT
  2967.     AX = 4402h
  2968.     BX = file handle for device "IFS$HLP$"
  2969.     CX = 0008h (size of buffer in bytes)
  2970.     DS:DX -> buffer for entry point record (see #0727 at AH=3Fh"IFSHLP")
  2971. Return: CF clear if successful
  2972.         buffer filled
  2973.     CF set on error
  2974.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2975. SeeAlso: AH=3Fh"IFSHLP"
  2976. --------D-214403-----------------------------
  2977. INT 21 - DOS 2+ - IOCTL - WRITE TO CHARACTER DEVICE CONTROL CHANNEL
  2978.     AX = 4403h
  2979.     BX = file handle referencing character device
  2980.     CX = number of bytes to write
  2981.     DS:DX -> data to write
  2982. Return: CF clear if successful
  2983.         AX = number of bytes actually written
  2984.     CF set on error
  2985.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  2986. Notes:    format of data is driver-specific (see below for some specific cases)
  2987.     if the file handle refers to "4DOSSTAK", the 4DOS (v2.x-3.03)
  2988.       KEYSTACK.SYS driver will push the specified characters on the
  2989.       keyboard stack; similarly for "NDOSSTAK", the NDOS KEYSTACK.SYS
  2990.       driver will push the characters onto the keyboard stack
  2991. SeeAlso: AX=4400h,AX=4402h,AX=4405h,INT 2F/AX=122Bh,INT 2F/AX=D44Dh
  2992. SeeAlso: INT 2F/AX=D44Fh
  2993. --------c-214403-----------------------------
  2994. INT 21 - SMARTDRV.SYS v3.x only - IOCTL - CACHE CONTROL
  2995.     AX = 4403h
  2996.     BX = handle for device "SMARTAAR"
  2997.     CX = number of bytes to write
  2998.     DS:DX -> SMARTDRV control block (see #0831)
  2999. Return: CF clear if successful
  3000.         AX = number of bytes actually written
  3001.         0000h if control block too small for given command
  3002.     CF set on error
  3003.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3004. Note:    NCache2 (from the Norton Utilities v8.0) attempts to support this
  3005.       interface, but does not do so correctly, often hanging the system;
  3006.       one should use the SmartDrive v4.x or NCache private interfaces
  3007.       (see INT 2F/AX=4A10h/BX=0000h,INT 2F/AX=FE00h/DI=4E55h)
  3008. SeeAlso: AX=4402h"SMARTDRV",INT 2F/AX=4A10h/BX=0000h
  3009.  
  3010. (Table 0830)
  3011. Values for SMARTDRV function code:
  3012.  00h    flush cache
  3013.  01h    flush and discard cache
  3014.  02h    disable caching (flushes and discards cache first)
  3015.  03h    enable caching
  3016.  04h    control write caching
  3017.  05h    set flushing tick count
  3018.  06h    lock cache contents
  3019.  07h    unlock cache contents
  3020.  08h    set flush-on-reboot flag
  3021.  09h    unused
  3022.  0Ah    control full-track caching
  3023.  0Bh    reduce cache size
  3024.  0Ch    increase cache size
  3025.  0Dh    set INT 13 chain address
  3026.  
  3027. Format of SMARTDRV control block:
  3028. Offset    Size    Description    (Table 0831)
  3029.  00h    BYTE    function code (see #0830)
  3030. ---functions 00h-03h,06h,07h---
  3031.  no additional fields
  3032. ---function 04h---
  3033.  01h    BYTE    write caching control action
  3034.         00h turn off write-through
  3035.         01h turn on write-through
  3036.         02h turn off write buffering (also flushes cache)
  3037.         03h turn on write buffering (also flushes cache)
  3038. ---function 05h---
  3039.  01h    WORD    number of timer ticks between cache flushes
  3040. ---function 08h---
  3041.  01h    BYTE    new flush-on-reboot flag (00h off, 01h on)
  3042. ---function 0Ah---
  3043.  01h    BYTE    full-track writes are
  3044.         00h not cached
  3045.         01h cached
  3046. ---functions 0Bh,0Ch---
  3047.  01h    WORD    number of 16K pages by which to increase/reduce cache size
  3048. ---function 0Dh---
  3049.  01h    DWORD    new address to which to chain on INT 13
  3050. Note:    the previous address is not preserved
  3051. --------d-214403-----------------------------
  3052. INT 21 - CD-ROM device driver - IOCTL OUTPUT
  3053.     AX = 4403h
  3054.     BX = file handle referencing character device for CD-ROM driver
  3055.     CX = number of bytes to write
  3056.     DS:DX -> control block (see #0832)
  3057. Return: CF clear if successful
  3058.         AX = number of bytes actually written
  3059.     CF set on error
  3060.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3061. SeeAlso: AX=4402h"CD-ROM",INT 2F/AX=0802h
  3062.  
  3063. Format of CR-ROM control block:
  3064. Offset    Size    Description    (Table 0832)
  3065.  00h    BYTE    function code
  3066.         00h eject disk
  3067.         01h lock/unlock door
  3068.         02h reset drive
  3069.         03h control audio channel
  3070.         04h write device control string
  3071.         05h close tray
  3072. ---functions 00h,02h,05h---
  3073.  no further fields
  3074. ---function 01h---
  3075.  01h    BYTE    lock function
  3076.         00h unlock door
  3077.         01h lock door
  3078. ---function 03h---
  3079.  01h    BYTE    input channel (0-3) for output channel 0
  3080.  02h    BYTE    volume for output channel 0
  3081.  03h    BYTE    input channel (0-3) for output channel 1
  3082.  04h    BYTE    volume for output channel 1
  3083.  05h    BYTE    input channel (0-3) for output channel 2
  3084.  06h    BYTE    volume for output channel 2
  3085.  07h    BYTE    input channel (0-3) for output channel 3
  3086.  08h    BYTE    volume for output channel 3
  3087. Note:    output channels 0 and 1 are left and right, 2 and 3 are left prime and
  3088.       right prime; a volume of 00h is off
  3089. ---function 04h---
  3090.  01h  N BYTEs    bytes to send directly to the CD-ROM drive without
  3091.           interpretation
  3092. --------d-214403-----------------------------
  3093. INT 21 - Brian Antoine Seagate ST-01 SCSI.SYS - IOCTL - EXECUTE COMMANDS
  3094.     AX = 4403h
  3095.     BX = handle for device "SCSITAPE"
  3096.     CX = number of bytes to write
  3097.     DS:DX -> SCSITAPE control block (see #0833)
  3098. Return: CF clear if successful
  3099.         AX = number of bytes actually written
  3100.     CF set on error
  3101.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3102. SeeAlso: AX=4405h"ST-01",INT 78/AH=10h
  3103.  
  3104. Format of SCSITAPE control block:
  3105. Offset    Size    Description    (Table 0833)
  3106.  00h    WORD    command type
  3107.         'F' Format (argument 1 = interleave, argument 2 = format type)
  3108.         'E' Erase
  3109.         'R' Rewind
  3110.         'L' Load
  3111.         'N' No Load
  3112.         'S' Space (argument 1 = count, argument 2 = type)
  3113.         'M' File Mark (argument 1 = count)
  3114.         'A' Reassign
  3115.  02h    WORD    argument 1
  3116.  04h    WORD    argument 2
  3117.  06h    WORD    segment of command buffer
  3118.  08h    WORD    offset of command buffer
  3119.  0Ah    WORD    length of command buffer
  3120. --------E-214403-----------------------------
  3121. INT 21 U - AI Architects - OS/x86??? - API
  3122.     AX = 4403h
  3123.     BX = handle for device "AIA_OS"
  3124.     CX = number of bytes to write (ignored)
  3125.     DS:DX -> 12-byte buffer (see #0834), first byte is command:
  3126.           81h installation check
  3127.           82h get API entry point
  3128.           84h uninstall
  3129. Return: CF clear if successful
  3130.         AX = number of bytes actually written
  3131.         DS:DX buffer filled
  3132.     CF set on error
  3133.         AX = error code (01h,05h,06h,0Ch,0Dh) (see #0980 at AH=59h)
  3134. Notes:    these functions are only available if the DOS extender was loaded as a
  3135.       device driver in CONFIG.SYS
  3136.     called by TKERNEL (a licensed version of AI Architects/Ergo OS/x86)
  3137. SeeAlso: INT 2F/AX=FBA1h/BX=0081h,INT 2F/AX=FBA1h/BX=0082h
  3138. Index:    installation check;OS/x86|entry point;OS/x86|uninstall;OS/x86
  3139.  
  3140. Format of buffer on return:
  3141. Offset    Size    Description    (Table 0834)
  3142.  00h  4 BYTEs    signature "IABH"
  3143. ---if function 81h---
  3144.  (no additional fields)
  3145. ---if function 82h---
  3146.  04h    DWORD    pointer to API entry point (see INT 2F/AX=FBA1h/BX=0082h)
  3147. ---if function 84h---
  3148.  04h    WORD    success indicator
  3149.  06h    WORD    segment of ???
  3150.  08h    WORD    segment of ??? memory block to free if nonzero
  3151.  0Ah    WORD    segment of ??? memory block to free if nonzero
  3152. --------V-214403-----------------------------
  3153. INT 21 - PGS1600.DEV - IOCTL - SET CONFIGURATION???
  3154.     AX = 4403h
  3155.     BX = file handle for device "PGS1600$"
  3156.     CX = 0018h (size of buffer)
  3157.     DS:DX -> configuration buffer (see #0792 at AX=4402h"PGS1600")
  3158. Return: CF clear if successful
  3159.         AX = number of bytes actually written
  3160.     CF set on error
  3161.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3162. Program: PGS1600.DEV is a device driver for the Cornerstone Technology PG1600
  3163.       display adapter, which provides a 1600x1200 monochrome display as
  3164.       well as one of two emulations, MDA or CGA.
  3165. SeeAlso: AX=4402h"PGS1600"
  3166. --------N-214403-----------------------------
  3167. INT 21 - PC/TCP IPCUST.SYS - RESET CONFIGURATION DATA READ POINTER
  3168.     AX = 4403h
  3169.     BX = file handle referencing device "$IPCUST"
  3170.     CX, DS:DX ignored
  3171. Return: CF clear if successful
  3172.         AX destroyed
  3173.     CF set on error
  3174.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3175. Notes:    there are a total of 378h bytes of configuration data for IPCUST.SYS
  3176.       version 2.05.     If less than the entire data is read or written,
  3177.       the next read/write continues where the previous one ended; this
  3178.       call and AX=4402h both reset the location at which the next
  3179.       operation starts to zero
  3180.     v2.1+ uses a new configuration method, but allows the installation
  3181.       of IPCUST.SYS for backward compatibility with other software which
  3182.       must read the PC/TCP configuration
  3183. SeeAlso: AH=3Fh"IPCUST",AH=40h"IPCUST",AX=4402h"IPCUST"
  3184. --------V-214403-----------------------------
  3185. INT 21 - Compaq AG1024.SYS - CPQ_MGES - IOCTL OUTPUT
  3186.     AX = 4403h
  3187.     BX = file handle referencing device "CPQ_MGES"
  3188.     DS:DX -> request packet (see #0835)
  3189.     CX ignored
  3190. Return: CF clear if successful
  3191.         AX destroyed
  3192.         data buffer filled (if applicable)
  3193.         first word of request packet set to number of bytes of data
  3194.           available (amount returned is smaller of this and requested
  3195.           amount)
  3196.     CF set on error
  3197.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3198. Program: AG1024.SYS is a device driver for the Advanced Graphics 1024 adapter
  3199. SeeAlso: AX=4403h"RGDI"
  3200.  
  3201. Format of Compaq AG1024.SYS request packet:
  3202. Offset    Size    Description    (Table 0835)
  3203.  00h    WORD    function
  3204.         0000h get ??? (26h bytes)
  3205.         0001h get ??? (36h bytes)
  3206.         0002h set ??? (same as returned by function 0001h)
  3207.         0003h get ??? (6 bytes)
  3208.         0004h get ???
  3209.         0005h get ???
  3210.         0006h get ??? (10h bytes)
  3211.         0007h set ??? (same as returned by function 0006h)
  3212. ---functions 00h-03h,06h,07h---
  3213.  02h    WORD    size of data buffer
  3214.  04h    DWORD    -> buffer for function's data
  3215.  ---functions 04h,05h---
  3216.  02h    WORD    ???
  3217.  04h    WORD    size of data buffer
  3218.  06h    DWORD    -> buffer to receive data
  3219. --------V-214403-----------------------------
  3220. INT 21 - Compaq AG1024.SYS - RGDI - IOCTL OUTPUT
  3221.     AX = 4403h
  3222.     BX = file handle referencing device "$$$$RGDI"
  3223.     DS:DX -> request packet (see #0836)
  3224.     CX ignored
  3225. Return: CF clear if successful
  3226.         AX destroyed
  3227.         data buffer filled (if applicable)
  3228.         first word of request packet set to number of bytes of data
  3229.           available (amount returned is smaller of this and requested
  3230.           amount)
  3231.     CF set on error
  3232.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3233. Program: AG1024.SYS is a device driver for the Advanced Graphics 1024 adapter
  3234. SeeAlso: AX=4402h"RGDI",AX=4403h"CPQ_MGES"
  3235.  
  3236. Format of Compaq AG1024.SYS request packet:
  3237. Offset    Size    Description    (Table 0836)
  3238.  00h    WORD    function
  3239.         0000h get entry points
  3240.         0001h get ???
  3241.  02h    DWORD    address of buffer for returned data
  3242. --------m-214403SF01-------------------------
  3243. INT 21 U - Qualitas 386MAX v6.01+ - TURN 386MAX OFF
  3244.     AX = 4403h subfn 01h
  3245.     BX = handle for device "386MAX$$"
  3246.     DS:DX -> BYTE 01h
  3247.     CX ignored
  3248. Return: DS:DX -> BYTE status (00h = successful)
  3249.     CF clear if successful
  3250.         AX destroyed
  3251.     CF set on error
  3252.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3253. Note:    this function will fail if any EMS or UMBs are in use
  3254. SeeAlso: AX=4403h/SF=02h,AX=4403h/SF=03h,AX=4403h/SF=05h
  3255. --------m-214403SF02-------------------------
  3256. INT 21 U - Qualitas 386MAX v6.01+ - TURN 386MAX ON
  3257.     AX = 4403h subfn 02h
  3258.     BX = handle for device "386MAX$$"
  3259.     DS:DX -> BYTE 02h
  3260.     CX ignored
  3261. Return: DS:DX -> BYTE status (00h = successful)
  3262.     CF clear if successful
  3263.         AX destroyed
  3264.     CF set on error
  3265.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3266. SeeAlso: AX=4403h/SF=01h,AX=4403h/SF=03h,AX=4403h/SF=05h
  3267. --------m-214403SF03-------------------------
  3268. INT 21 U - Qualitas 386MAX v6.01+ - SET STATE
  3269.     AX = 4403h subfn 03h
  3270.     BX = handle for device "386MAX$$"
  3271.     CX = number of bytes to copy (up to size of state buffer)
  3272.     DS:DX -> BYTE 03h followed by state buffer
  3273.           (see #0775 at AX=4402h"386MAX")
  3274. Return: CF clear if successful
  3275.         AX = number of bytes actually written
  3276.     CF set on error
  3277.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3278. Note:    the first byte of the buffer must be either 01h, 02h, or 03h
  3279.       (specifying the version of the state record) and the buffer must
  3280.       contain CX bytes AFTER the initial byte
  3281. SeeAlso: AX=4402h"386MAX"
  3282. --------m-214403SF05-------------------------
  3283. INT 21 U - Qualitas 386MAX v7.00+ - LIMIT AUTOMATIC ACTIVATION TO STD EMS CALLS
  3284.     AX = 4403h subfn 05h
  3285.     BX = handle for device "386MAX$$"
  3286.     DS:DX -> BYTE 05h
  3287.     CX ignored
  3288. Return: CF clear if successful
  3289.         AX destroyed
  3290.     CF set on error
  3291.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3292. Desc:    specifies that 386MAX will only shift from AUTO to ON mode on standard
  3293.       EMS calls INT 67/AH=40h-5Dh
  3294. SeeAlso: AX=4403h/SF=02h,AX=4403h/SF=03h,AX=4403h/SF=06h
  3295. --------m-214403SF06-------------------------
  3296. INT 21 U - Qualitas 386MAX v7.00+ - ALLOW AUTOMATIC ACTIVATION ON ANY INT 67
  3297.     AX = 4403h subfn 06h
  3298.     BX = handle for device "386MAX$$"
  3299.     DS:DX -> BYTE 06h
  3300.     CX ignored
  3301. Return: CF clear if successful
  3302.         AX destroyed
  3303.     CF set on error
  3304.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3305. Desc:    specified that 386MAX should shift from AUTO to ON mode on any INT 67
  3306.       call other than INT 67/AH=3Fh
  3307. SeeAlso: AX=4403h/SF=01h,AX=4403h/SF=03h,AX=4403h/SF=05h
  3308. --------n-214403-----------------------------
  3309. INT 21 U - PenDOS PENDEV.SYS - ???
  3310.     AX = 4403h
  3311.     BX = file handle for device "$$PENDOS" or "$$PD_REG"
  3312.     CX = size of buffer
  3313.     DS:DX -> buffer containing ???
  3314. Return: CF clear if successful
  3315.         buffer filled
  3316.     CF set on error
  3317.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3318. Program: A limited version of PenDOS by Communication Intelligence Corporation,
  3319.       which provides pen capability to keyboard-based programs, is bundled
  3320.       with IBM DOS 6.1
  3321. Note:    this call sets the WORD at offset 1Ah into the device driver request
  3322.       header used to call the driver to 0000h.
  3323. SeeAlso: AX=4402h"PENDEV.SYS"
  3324. --------D-214404-----------------------------
  3325. INT 21 - DOS 2+ - IOCTL - READ FROM BLOCK DEVICE CONTROL CHANNEL
  3326.     AX = 4404h
  3327.     BL = drive number (00h = default, 01h = A:, etc.)
  3328.     CX = number of bytes to read
  3329.     DS:DX -> buffer
  3330. Return: CF clear if successful
  3331.         AX = number of bytes actually read
  3332.     CF set on error
  3333.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3334. Note:    format of data is driver-specific
  3335. SeeAlso: AX=4402h,AX=4405h,INT 2F/AX=122Bh
  3336. --------k-214404-----------------------------
  3337. INT 21 - Stacker - GET DEVICE DRIVER ADDRESS AND SET VOLUME NUMBER
  3338.     AX = 4404h
  3339.     BL = drive number (00h = default, 01h = A:, etc.)
  3340.     CX = 0004h
  3341.     DS:DX -> DWORD buffer to receive device driver address
  3342. Return: buffer filled with pointer into Stacker device driver (see #1839):
  3343.       driver + 19h if Stacker Anywhere controls this drive
  3344.       driver + 1Ah if Stacker controls this drive
  3345.       unchanged else
  3346. Notes:    in addition to returning the address of the Stacker device driver,
  3347.       this call also sets the volume number at offset 58h in the device
  3348.       driver (see #1839 at INT 25/AX=CDCDh)
  3349.     Stacker Anywhere does not link its built-in device driver into
  3350.       the standard device driver chain, but it can be found via CDS/DPB
  3351.     this call can be used as an installation check for all versions of
  3352.       Stacker and Stacker Anywhere to avoid the INT 25 call
  3353. SeeAlso: AX=4408h,AX=440Eh,AH=52h,INT 25/AX=CDCDh
  3354. --------k-214404-----------------------------
  3355. INT 21 - Stacker - GET STACVOL FILE SECTORS
  3356.     AX = 4404h
  3357.     BL = drive number (0 is current drive)
  3358.     CX = byte count (i.e., 200h = 1 sector)
  3359.     DS:DX -> buffer (see #0837)
  3360. Return: Data Buffer contains the number of sectors requested from the
  3361.       STACVOL physical file for the drive specified.
  3362.  
  3363. Format of Stacker buffer:
  3364. Offset    Size    Description    (Table 0837)
  3365.  00h    WORD    01CDh
  3366.  02h    WORD    sector count
  3367.  04h    DWORD    number of starting sector
  3368.  08h    DWORD    far pointer to Data Buffer
  3369. --------k-214404-----------------------------
  3370. INT 21 - DUBLDISK.SYS v2.6 - GET INFO
  3371.     AX = 4404h
  3372.     BL = drive number of DoubleDisk drive (00h = default, 01h = A:, etc.)
  3373.     CX = number of bytes (000Ah-0014h, call ignored otherwise)
  3374.     DS:DX -> data record (see #0838)
  3375. Return: CF clear if successful
  3376.         AX = number of bytes read
  3377.     CF set on error
  3378.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3379. Program: DUBLDISK.SYS is the device driver portion of DoubleDisk, a disk
  3380.       expander by Vertisoft Systems, Inc.
  3381. Note:    the installation check for v2.6 consists of scanning memory for the
  3382.       signature "FAT 2.6  byte:", which is immediately followed by a data
  3383.       table (see #0839)
  3384. BUG:    VOPT (a disk optimizer by Golden Bow Software) assumes that any driver
  3385.       which returns the "correct" number of bytes when the first word of
  3386.       the buffer for the data record contains the signature value 4444h is
  3387.       DoubleDisk; a workaround is for the non-DoubleDisk driver to return
  3388.       no data if the signature is present
  3389. SeeAlso: AX=440Dh
  3390. Index:    installation check;DUBLDISK.SYS
  3391.  
  3392. Format of DUBLDISK data record:
  3393. Offset    Size    Description    (Table 0838)
  3394.  00h    WORD    (call) signature 4444h
  3395.  02h    BYTE    (call) function
  3396.             00h ???
  3397.             01h ???
  3398. ---function 00h---
  3399.  02h    BYTE    (ret) ???
  3400.  03h    BYTE    (ret) ???
  3401. ---function 01h---
  3402.  02h    WORD    (ret) 4444h
  3403.  04h    WORD    allocation unit size???
  3404.  06h    WORD    ???
  3405.  08h    WORD    ???
  3406.  0Ah    BYTE    ???
  3407.  
  3408. Format of DUBLDISK signature data table:
  3409. Offset    Size    Description    (Table 0839)
  3410.  00h  5 BYTEs    ???
  3411.  05h    BYTE    first drive number
  3412.  06h    BYTE    number of drives
  3413.  07h    ???
  3414. --------k-214404-----------------------------
  3415. INT 21 - DBLSPACE.BIN - IOCTL - FLUSH OR INVALIDATE INTERNAL CACHES
  3416.     AX = 4404h
  3417.     BL = drive number (00h = default, 01h = A:, etc)
  3418.     CX = 000Ah (size of DSPACKET structure)
  3419.     DS:DX -> DSPACKET structure (see #0840)
  3420. Return: CF clear if IOCTL successful -- check DSPACKET for actual status
  3421.         AX = number of bytes actually transferred
  3422.     CF set on error
  3423.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3424. SeeAlso: AX=4405h"DBLSPACE",INT 2F/AX=4A11h/BX=0000h
  3425.  
  3426. Format of DoubleSpace DSPACKET structure:
  3427. Offset    Size    Description    (Table 0840)
  3428.  00h    WORD    signature 444Dh ("DM")
  3429.  02h    BYTE    command code
  3430.         46h ('F') flush internal caches
  3431.         49h ('I') flush and invalidate internal caches
  3432.  03h    WORD    result code
  3433.         (ret) 4F4Bh ("OK") if successful, else unchanged
  3434.  05h  5 BYTEs    padding
  3435. --------k-214404-----------------------------
  3436. INT 21 - DBLSPACE.BIN v6.2 - IOCTL - GET ??? FOR SPECIFIED DRIVE
  3437.     AX = 4404h
  3438.     BL = drive number (00h = default, 01h = A:, etc)
  3439.     CX = size of DSPACKET structure (ignored in DOS 6.2)
  3440.     DS:DX -> DSPACKET structure (see #0841)
  3441. Return: CF clear if IOCTL successful -- check DSPACKET for actual status
  3442.         AX = number of bytes actually transferred
  3443.     CF set on error
  3444.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3445. SeeAlso: AX=4405h"DBLSPACE",INT 2F/AX=4A11h/BX=0000h
  3446.  
  3447. Format of DoubleSpace DSPACKET structure:
  3448. Offset    Size    Description    (Table 0841)
  3449.  00h    WORD    signature 444Dh ("DM")
  3450.  02h    BYTE    command code
  3451.         53h ('S') get ??? for specified drive
  3452.  03h    WORD    result code
  3453.         (ret) 4F4Bh ("OK") if successful, else unchanged
  3454.  05h    DWORD    (ret) pointer to 96-byte ??? data
  3455.  09h    DWORD    (ret) pointer to ??? data
  3456.  0Dh  3 BYTEs    reserved
  3457. --------k-214404-----------------------------
  3458. INT 21 U - DoubleTools v1.0 - GET ???
  3459.     AX = 4404h
  3460.     BL = drive number (00h = default, 01h = A:, etc)
  3461.     CX = 0006h
  3462.     DS:DX -> DoubleTools structure (see #0842)
  3463. Return: CF clear if IOCTL successful -- check DSPACKET for actual status
  3464.         AX = number of bytes actually transferred
  3465.     CF set on error
  3466.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3467. Note:    the Transporter device driver has the signature 55h 61h 50h 74h
  3468.       ("DaPt") twelve bytes after it beginning
  3469.  
  3470. Format of DoubleTools structure:
  3471. Offset    Size    Description    (Table 0842)
  3472.  00h    WORD    (call) signature 55h AAh
  3473.         (ret) signature 78h 70h ("xp")
  3474.  02h    WORD    (call) signature 52h 16h
  3475.         (ret) ???
  3476.  04h    WORD    (ret) segment of driver's DS (same as its PSP)
  3477. --------d-214404-----------------------------
  3478. INT 21 U - xDISK v3.31 - CONFIGURE
  3479.     AX = 4404h
  3480.     BL = drive number (00h = default, 01h = A:, etc)
  3481.     CX = 0047h (length of version string)
  3482.     DS:DX -> 79-byte buffer for version string and ???
  3483.     DS:0081h = commandline containing new switches for driver
  3484. Return: CF clear if successful
  3485.         AX = number of bytes actually transferred
  3486.     CF set on error
  3487.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3488. Program: xDISK is a shareware resizeable EMS RAMdisk by FM de Monasterio
  3489. SeeAlso: AX=4405h"xDISK",INT 2F/AH=DDh/BX=7844h"xDISK"
  3490. --------c-214404-----------------------------
  3491. INT 21 - COMBI-disk v1.13 - GET DATA RECORD
  3492.     AX = 4404h
  3493.     BL = drive number (00h = default, 01h = A:, etc)
  3494.     CX = 0032h (length of data packet)
  3495.     DS:DX -> buffer for data packet (see #0843)
  3496. Return: CF clear if successful
  3497.         AX = number of bytes actually transferred
  3498.     CF set on error
  3499.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3500. Program: COMBI-disk is a shareware combination cache and RAMdisk sharing a
  3501.       single pool of memory by Vadim V. Vlasov
  3502. Note:    the installation check consists of scanning the valid drives for one
  3503.       which returns a correctly-sized data packet with the proper
  3504.       signature in the first field
  3505. SeeAlso: AX=4405h"COMBI"
  3506. Index:    installation check;COMBI-disk
  3507.  
  3508. Format of COMBI-disk data packet:
  3509. Offset    Size    Description    (Table 0843)
  3510.  00h  6 BYTEs    ASCIZ signature "COMBI"
  3511.  06h    WORD    version (high byte = major, low = decimal minor version)
  3512.  08h    BYTE    current options (see below)
  3513.  09h    BYTE    sectors per allocation block
  3514.  0Ah    WORD    maximum buffer in KB
  3515.  0Ch    WORD    current buffer in KB (less than max if XMS memory being lent)
  3516.  0Eh    WORD    total number of allocation blocks
  3517.  10h    WORD    current number of allocation blocks
  3518.  12h    WORD    number of blocks being used by RAM disk
  3519.  14h    WORD    number of blocks being used by cache or unused
  3520.  16h    WORD    number of dirty cache blocks
  3521.  18h    WORD    number of blocks which could not be written out due to errors
  3522.  1Ah    WORD    total number of read requests
  3523.  1Ch    WORD    total number of sectors read
  3524.  1Eh    WORD    number of BIOS read requests (cache misses)
  3525.  20h    WORD    number of sectors read via BIOS (cache misses)
  3526.  22h    WORD    total number of write requests
  3527.  24h    WORD    total number of sectors written
  3528.  26h    WORD    number of BIOS write requests
  3529.  28h    WORD    number of sectors written via BIOS
  3530.  2Ah    WORD    number of RAM disk read requests
  3531.  2Ch    WORD    number of sectors read from RAM disk
  3532.  2Eh    WORD    number of RAM disk write requests
  3533.  30h    WORD    number of sectors written to RAM disk
  3534. --------d-214404-----------------------------
  3535. INT 21 - SFS v1.00 - GET CONFIGURATION INFORMATION
  3536.     AX = 4404h
  3537.     BL = drive number (00h = default, 01h = A:, etc)
  3538.     CX = 001Ah (length of data packet)
  3539.     DS:DX -> buffer for data packet (see #0844)
  3540. Return: CF clear if successful
  3541.         AX = number of bytes actually transferred
  3542.     CF set on error
  3543.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3544. Program: SFS (Secure FileSystem) is a shareware encrypting disk driver by
  3545.       Peter C. Gutmann
  3546. SeeAlso: AX=4405h"SFS"
  3547.  
  3548. Format of SFS data packet:
  3549. Offset    Size    Description    (Table 0844)
  3550.  00h  4 BYTEs    signature string "SFS1"
  3551.  04h    WORD    SFS unit number (0-based)
  3552.  06h    WORD    drive on which the SFS volume is mounted
  3553.  08h    DWORD    sector offset of logical volume from start of physical volume
  3554.         0 if logical volume = physical volume
  3555.  0Ch    WORD    flag: 00h = no disk mounted, 01h = disk mounted
  3556.  0Eh    WORD    flag: 00h read/write, 01h read-only
  3557.  10h    WORD    quick-unmount hotkey
  3558.         (high byte = shift state, low = scan code) (see #0005)
  3559.  12h    WORD    auto-unmount time in minutes, or 0000h if already expired, or
  3560.         FFFFh if not set
  3561.  14h    WORD    time in minutes remaining before auto-unmount
  3562.  16h    WORD    internal driver check code
  3563.         0000h no error
  3564.         0001h driver consistency check failed
  3565.         0002h unit consistency check failed
  3566.  18h    WORD    disk access mode
  3567.         0000h BIOS
  3568.         0001h IDE direct access
  3569.         0002h SCSI direct access
  3570. --------D-214405-----------------------------
  3571. INT 21 - DOS 2+ - IOCTL - WRITE TO BLOCK DEVICE CONTROL CHANNEL
  3572.     AX = 4405h
  3573.     BL = drive number (00h = default, 01h = A:, etc)
  3574.     CX = number of bytes to write
  3575.     DS:DX -> data to write
  3576. Return: CF clear if successful
  3577.         AX = number of bytes actually written
  3578.     CF set on error
  3579.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3580. Note:    format of data is driver-specific
  3581. SeeAlso: AX=4403h,AX=4404h,INT 2F/AX=122Bh
  3582. --------d-214405-----------------------------
  3583. INT 21 - Brian Antoine Seagate ST-01 SCSI.SYS - IOCTL - EXECUTE COMMANDS
  3584.     AX = 4405h
  3585.     BX = drive number (00h = default, 01h = A:, etc)
  3586.     CX = number of bytes to write
  3587.     DS:DX -> SCSIDISK control block (see also #0833 at AX=4403h"ST-01")
  3588. Return: CF clear if successful
  3589.         AX = number of bytes actually written
  3590.     CF set on error
  3591.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3592. SeeAlso: AX=4403h"ST-01"
  3593. --------k-214405-----------------------------
  3594. INT 21 U - DBLSPACE.BIN - IOCTL - FLUSH OR INVALIDATE INTERNAL CACHES
  3595.     AX = 4405h
  3596.     BL = drive number (00h = default, 01h = A:, etc)
  3597.     CX = 000Ah (size of DSPACKET structure)
  3598.     DS:DX -> DSPACKET structure (see #0845)
  3599. Return: CF clear if IOCTL successful -- check DSPACKET for actual status
  3600.         AX = number of bytes actually transferred
  3601.     CF set on error
  3602.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3603. Note:    this call is identical to the documented AX=4404h
  3604. SeeAlso: AX=4404h"DBLSPACE",INT 2F/AX=4A11h/BX=0000h
  3605.  
  3606. Format of DoubleSpace DSPACKET structure:
  3607. Offset    Size    Description    (Table 0845)
  3608.  00h    WORD    signature 444Dh ("DM")
  3609.  02h    BYTE    command code
  3610.         46h ('F') flush internal caches
  3611.         49h ('I') flush and invalidate internal caches
  3612.  03h    WORD    result code
  3613.         (ret) 4F4Bh ("OK") if successful, else unchanged
  3614.  05h  5 BYTEs    padding
  3615. --------d-214405-----------------------------
  3616. INT 21 U - xDISK v3.31 - ???
  3617.     AX = 4405h
  3618.     BL = drive number (00h = default, 01h = A:, etc)
  3619.     CX = number of bytes to write
  3620.     DS:DX -> buffer containing version string
  3621.     ???
  3622. Return: CF clear if successful
  3623.         AX = number of bytes actually transferred
  3624.     CF set on error
  3625.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3626. Program: xDISK is a shareware resizeable EMS RAMdisk by FM de Monasterio
  3627. SeeAlso: AX=4404h"xDISK",INT 2F/AH=DDh/BX=7844h"xDISK"
  3628. --------d-214405-----------------------------
  3629. INT 21 - COMBI-disk v1.13 - CONTROL COMBI-disk
  3630.     AX = 4405h
  3631.     BL = drive number (00h = default, 01h = A:, etc) for RAM disk
  3632.     CX = number of bytes to write
  3633.     DS:DX -> buffer containing command packet (see #0847)
  3634. Return: CF clear if successful
  3635.         AX = number of bytes actually transferred
  3636.     CF set on error
  3637.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3638. SeeAlso: AX=4404h"COMBI"
  3639.  
  3640. (Table 0846)
  3641. Values for COMBI-disk command code:
  3642.  80h    flush cache
  3643.  81h    change options byte
  3644.  82h    shrink memory
  3645.  83h    expand memory
  3646.  84h    get dirty block information
  3647.  85h    reset write errors
  3648.  86h    reset counters
  3649.  
  3650. Format of COMBI-disk command packet:
  3651. Offset    Size    Description    (Table 0847)
  3652.  00h    WORD    version
  3653.  02h    BYTE    command code (see #0846)
  3654. ---command code 80h---
  3655.  no additional fields
  3656. ---command code 81h---
  3657.  03h    BYTE    new options byte (see #0848)
  3658. ---command code 82h---
  3659.  03h    WORD    number of KB to release
  3660. ---command code 83h---
  3661.  03h    WORD    number of KB to expand
  3662. ---command code 84h---
  3663.  03h    DWORD    -> buffer for block info (see #0849)
  3664. ---command code 85h---
  3665.  03h    DWORD    block ID
  3666. ---command code 86h---
  3667.  03h    BYTE    which counters to reset
  3668.         bit 0: hard disk read counts
  3669.         bit 1: hard disk write counts
  3670.         bit 2: RAM disk read/write counts
  3671. Note:    multiple commands may be placed in a single packet by stringing
  3672.       together as many command/argument pairs as desired
  3673.  
  3674. Bitfields for COMBI-disk options byte:
  3675. Bit(s)    Description    (Table 0848)
  3676.  0    cache off
  3677.  1    cache frozen
  3678.  2    write caching enabled
  3679.  3    delayed writing disabled
  3680.  5    fix memory allocation (no XMS lending)
  3681.  6    no 'sector not found' error
  3682.  
  3683. Format of COMBI-disk block info:
  3684. Offset    Size    Description    (Table 0849)
  3685.  00h    DWORD    block ID
  3686.  04h    BYTE    bitmask of valid sectors in block
  3687.  05h    BYTE    bitmask of dirty sectors in block
  3688.  06h    BYTE    last error returned by BIOS
  3689.  07h    BYTE    number of errors
  3690. --------D-214405-----------------------------
  3691. INT 21 - SFS v1.00 - DRIVER CONTROL
  3692.     AX = 4405h
  3693.     BL = drive number (00h = default, 01h = A:, etc)
  3694.     CX = number of bytes to write
  3695.     DS:DX -> data to write (see #0851)
  3696. Return: CF clear if successful
  3697.         AX = number of bytes actually written
  3698.     CF set on error
  3699.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3700. Program: SFS (Secure FileSystem) is a shareware encrypting disk driver by
  3701.       Peter C. Gutmann
  3702. SeeAlso: AX=4404h"SFS"
  3703.  
  3704. (Table 0850)
  3705. Values for SFS control function:
  3706.  00h    "PACKET_SET_DISKINFO"     set disk parameters
  3707.  01h    "PACKET_SET_KEYINFO"     set keying information
  3708.  02h    "PACKET_SET_READONLY"     select read/write or read-only
  3709.  03h    "PACKET_SET_DRIVENO"     set drive number to mount
  3710.  04h    "PACKET_SET_MOUNTSTATUS" set mount status
  3711.  05h    "PACKET_SET_UNMOUNT"     set/clear quick-unmount hotkey
  3712.  06h    "PACKET_SET_TIMEOUT"     set/clear auto-unmount timeout
  3713.  
  3714. Format of SFS control data packet:
  3715. Offset    Size    Description    (Table 0851)
  3716.  00h    WORD    signature 4330h ('C0')
  3717.  02h    WORD    function (see #0850)
  3718. ---function 00h---
  3719.  04h    WORD    sector size in bytes
  3720.  06h    BYTE    sectors per cluster
  3721.  07h    WORD    number of boot sectors
  3722.  09h    BYTE    number of copies of FAT
  3723.  0Ah    WORD    size of root directory in entries
  3724.  0Ch    WORD    number of sectors on disk, 16-bit
  3725.  0Eh    BYTE    media descriptor byte
  3726.  0Fh    WORD    sectors per FAT
  3727.  11h    WORD    sectors per track
  3728.  13h    WORD    number of heads
  3729.  15h    DWORD    number of hidden sectors
  3730.  19h    DWORD    number of sectors on disk, 32-bit
  3731. ---function 01h---
  3732.  04h 20 BYTEs    master IV for encrypted disk
  3733.  18h 64 BYTEs    NDC/SHS keying information
  3734. ---function 02h---
  3735.  04h    WORD    read-only state: 00h read-only, 01h read/write
  3736. ---function 03h---
  3737.  04h    WORD    drive number (see #0852)
  3738.  06h    DWORD    sector offset of logical volume from start of physical volume
  3739.         0 if logical volume = physical volume
  3740. ---function 04h---
  3741.  04h    WORD    mount status (00h unmounted, 01h mounted)
  3742. ---function 05h---
  3743.  04h    WORD    hotkey (high byte = shift state, low byte = scan code or 00h)
  3744.         (see #0005)
  3745.         0000h to disable hotkey
  3746. ---function 06h---
  3747.  04h    WORD    timeout in minutes before automatic unmount
  3748.         0000h to disable auto-unmount
  3749. Notes:    the data for function 00h corresponds to a DOS BPB (see AH=53h)
  3750.     functions 00h, 01h, and 03h automatically unmount the encrypted drive
  3751.     unmounting a drive with function 04h also destroys the encryption
  3752.       information in the driver and forces all dirty buffers to be flushed
  3753.  
  3754. Bitfields for SFS drive number:
  3755. Bit(s)    Description    (Table 0852)
  3756.  15-12    drive access mode
  3757.     0000 BIOS access
  3758.     0001 direct IDE access
  3759.     0010 direct SCSI access
  3760. ---if BIOS access---
  3761.  11-8    unused (0)
  3762.  7-0    BIOS drive number
  3763. ---if IDE access---
  3764.  11-8    unused (0)
  3765.  7-0    IDE drive number
  3766. ---if SCSI access---
  3767.  11-8    SCSI host number
  3768.  7-4    SCSI target ID
  3769.  3-0    SCSI logical unit number
  3770. --------D-214406-----------------------------
  3771. INT 21 - DOS 2+ - IOCTL - GET INPUT STATUS
  3772.     AX = 4406h
  3773.     BX = file handle
  3774. Return: CF clear if successful
  3775.         AL = input status
  3776.         00h not ready (device) or at EOF (file)
  3777.         FFh ready
  3778.     CF set on error
  3779.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3780. Note:    files may not register as being at EOF if positioned there by AH=42h
  3781. SeeAlso: AX=4407h,INT 2F/AX=122Bh
  3782. --------D-214407-----------------------------
  3783. INT 21 - DOS 2+ - IOCTL - GET OUTPUT STATUS
  3784.     AX = 4407h
  3785.     BX = file handle
  3786. Return: CF clear if successful
  3787.         AL = input status
  3788.         00h not ready
  3789.         FFh ready
  3790.     CF set on error
  3791.         AX = error code (01h,05h,06h,0Dh) (see #0980 at AH=59h)
  3792. Note:    for DOS 2+, files are always ready for output, even if the disk is
  3793.       full or no media is in the drive
  3794. SeeAlso: AX=4406h,INT 2F/AX=122Bh
  3795. --------D-214408-----------------------------
  3796. INT 21 - DOS 3.0+ - IOCTL - CHECK IF BLOCK DEVICE REMOVABLE
  3797.     AX = 4408h
  3798.     BL = drive number (00h = default, 01h = A:, etc)
  3799. Return: CF clear if successful
  3800.         AX = media type (0000h removable, 0001h fixed)
  3801.     CF set on error
  3802.         AX = error code (01h,0Fh) (see #0980 at AH=59h)
  3803. Note:    in addition to the normal operation, if Stacker is installed, this
  3804.       call also sets the volume number at offset 58h in the Stacker
  3805.       device driver (except under DR DOS 3.41-5.0, which do not pass
  3806.       through this call to the driver; use AX=440Eh instead)
  3807.       (see AX=4404h"Stacker",AX=440Eh,INT 25/AX=CDCDh)
  3808. SeeAlso: AX=4400h,AX=4404h"Stacker",AX=4409h,INT 2F/AX=122Bh
  3809. --------D-214409-----------------------------
  3810. INT 21 - DOS 3.1+ - IOCTL - CHECK IF BLOCK DEVICE REMOTE
  3811.     AX = 4409h
  3812.     BL = drive number (00h = default, 01h = A:, etc)
  3813. Return: CF clear if successful
  3814.         DX = device attribute word
  3815.         bit 15: drive is SUBSTituted
  3816.         bit 12: drive is remote
  3817.         bit  9: direct I/O not allowed
  3818.     CF set on error
  3819.         AX = error code (01h,0Fh) (see #0980 at AH=59h)
  3820. Note:    on local drives, DX bits not listed above are the attribute word from
  3821.       the device driver header (see #0953 at AH=52h); for remote drives,
  3822.       the other bits appear to be undefined for DOS versions prior to 5.0
  3823.       (they are all cleared in DOS 5+)
  3824.     checking whether DX=0800h on return appears to be a fairly reliable
  3825.       method for detecting Microsoft's RAMDRIVE, though not for other
  3826.       ramdisks (there appears to be no simple yet foolproof method for
  3827.       detecting ramdisks, although the presence of only a single copy of
  3828.       the FAT and only a single head on non-removable devices is a fairly
  3829.       good indicator)
  3830. SeeAlso: AX=4400h,AX=4408h,AX=440Ah,INT 2F/AX=122Bh
  3831. --------D-21440A-----------------------------
  3832. INT 21 - DOS 3.1+ - IOCTL - CHECK IF HANDLE IS REMOTE
  3833.     AX = 440Ah
  3834.     BX = handle
  3835. Return: CF clear if successful
  3836.         DX = attribute word (as stored in SFT)
  3837.         bit 15: set if remote
  3838.         bit 14: date/time not set on close
  3839.     CF set on error
  3840.         AX = error code (01h,06h) (see #0980 at AH=59h)
  3841. Notes:    if file is remote, Novell Advanced NetWare 2.0 returns the number of
  3842.       the file server on which the handle is located in CX
  3843.     DR DOS 3.41 and 5.0 clear all bits of DX except bit 15
  3844. SeeAlso: AX=4400h,AX=4409h,AH=52h,INT 2F/AX=122Bh
  3845. --------D-21440B-----------------------------
  3846. INT 21 - DOS 3.1+ - IOCTL - SET SHARING RETRY COUNT
  3847.     AX = 440Bh
  3848.     CX = pause between retries (default 1)
  3849.     DX = number of retries (default 3)
  3850. Return: CF clear if successful
  3851.     CF set on error
  3852.         AX = error code (01h) (see #0980 at AH=59h)
  3853. Notes:    delay is dependent on processor speed (value in CX specifies number of
  3854.       64K-iteration empty loops to execute)
  3855.     if DX=0000h on entry, the retry count is left unchanged
  3856. SeeAlso: AH=52h,INT 2F/AX=1224h,INT 2F/AX=122Bh
  3857. --------D-21440C-----------------------------
  3858. INT 21 - DOS 3.2+ - IOCTL - GENERIC CHARACTER DEVICE REQUEST
  3859.     AX = 440Ch
  3860.     BX = device handle
  3861.     CH = category code (see #0853)
  3862.     CL = function number (see #0854)
  3863.     DS:DX -> parameter block (see #0855,#0856,#0857,#0858,#0859,#0860)
  3864.     SI = parameter to pass to driver (European MS-DOS 4.0, OS/2 comp box)
  3865.     DI = parameter to pass to driver (European MS-DOS 4.0, OS/2 comp box)
  3866. Return: CF set on error
  3867.         AX = error code (see #0980 at AH=59h)
  3868.     CF clear if successful
  3869.         DS:DX -> iteration count if CL=65h
  3870.         SI = returned value (European MS-DOS 4.0, OS/2 comp box)
  3871.         DI = returned value (European MS-DOS 4.0, OS/2 comp box)
  3872. Note:    DR DOS 3.41 and 5.0 return error code 16h on CL=45h,65h if the device
  3873.       does not support a retry counter
  3874. SeeAlso: AX=440Dh,INT 2F/AX=0802h,INT 2F/AX=122Bh,INT 2F/AX=14FFh
  3875. SeeAlso: INT 2F/AX=1A01h
  3876.  
  3877. (Table 0853)
  3878. Values for IOCTL category code:
  3879.  00h    unknown (DOS 3.3+)
  3880.  01h    COMn: (DOS 3.3+)
  3881.  03h    CON (DOS 3.3+)
  3882.  05h    LPTn:
  3883.  9Eh    Media Access Control driver (STARLITE)
  3884.  00h-7Fh reserved for Microsoft
  3885.  80h-FFh reserved for OEM/user-defined
  3886.  
  3887. (Table 0854)
  3888. Values for generic character IOCTL function:
  3889.  00h    MAC driver Bind (STARLITE) (see #0855)
  3890.  45h    set iteration (retry) count (see #0856)
  3891.  4Ah    select code page (see #0857)
  3892.  4Ch    start code-page preparation (see #0858)
  3893.  4Dh    end code-page preparation (see #0859)
  3894.  5Fh    set display information (DOS 4.0+) (see #0860)
  3895.  65h    get iteration (retry) count
  3896.  6Ah    query selected code page (see #0857)
  3897.  6Bh    query prepare list (see #0861)
  3898.  7Fh    get display information (DOS 4.0+) (see #0860)
  3899. Note:    bit assignments for function code:
  3900.         bit 7: set to ignore if unsupported, clear to return error
  3901.         bit 6: set if passed to driver, clear if intercepted by DOS
  3902.         bit 5: set if queries data from device, clear if sends command
  3903.         bits 4-0: subfunction
  3904.  
  3905. Format of parameter block for function 00h:
  3906. Offset    Size    Description    (Table 0855)
  3907.  00h  8 BYTEs    ASCIZ signature "STARMAC"
  3908.  08h    WORD    version
  3909.  0Ah    WORD    flags
  3910.         bit 0: media requires connect or listen request before use
  3911.         bit 1: network is a LAN (broadcast/multicast supported)
  3912.         bit 2: point-to-point network
  3913.  0Ch    WORD    handle for use with MAC driver's private interface (filled in
  3914.         by MAC driver)
  3915.  0Eh    WORD    context
  3916.  10h    WORD    approximate speed in KB/sec (filled in by MAC driver)
  3917.  12h    WORD    approximate cost in cents per hour (filled in by MAC driver)
  3918.  14h    WORD    maximum packet size in bytes (filled in by MAC driver)
  3919.  16h    WORD    addressing format (filled in by MAC driver)
  3920.         0000h general addressing
  3921.         0001h Ethernet addressing
  3922.         0002h Token Ring addressing
  3923.         0003h Token Bus addressing
  3924.  18h    DWORD    Send entry point (filled in by MAC driver)
  3925.  1Ch    DWORD    RegisterEventHandler entry point (filled in by MAC driver)
  3926.  20h    DWORD    SetPacketFilter entry point (filled in by MAC driver)
  3927.  24h    DWORD    UnBind entry point (filled in by MAC driver)
  3928.  
  3929. Format of parameter block for function 45h:
  3930. Offset    Size    Description    (Table 0856)
  3931.  00h    WORD    number of times output is attempted before driver assumes
  3932.           device is busy
  3933.  
  3934. Format of parameter block for functions 4Ah and 6Ah:
  3935. Offset    Size    Description    (Table 0857)
  3936.  00h    WORD    length of data
  3937.  02h    WORD    code page ID (see #1060 at INT 21/AX=6602h)
  3938.  04h 2N BYTEs    DCBS (double byte character set) lead byte range
  3939.           start/end for each of N ranges (DOS 4.0)
  3940.     WORD    0000h  end of data (DOS 4.0)
  3941.  
  3942. Format of parameter block for function 4Ch:
  3943. Offset    Size    Description    (Table 0858)
  3944.  00h    WORD    flags
  3945.         DISPLAY.SYS = 0000h
  3946.         PRINTER.SYS bit 0 clear to prepare downloaded font, set to
  3947.             prepare cartridge selection
  3948.  02h    WORD    length of remainder of parameter block
  3949.  04h    WORD    number of code pages following
  3950.  06h  N WORDs    code page 1,...,N
  3951.  
  3952. Format of parameter block for function 4Dh:
  3953. Offset    Size    Description    (Table 0859)
  3954.  00h    WORD    length of data
  3955.  02h    WORD    code page ID (see #1060 at INT 21/AX=6602h)
  3956.  
  3957. Format of parameter block for functions 5Fh and 7Fh:
  3958. Offset    Size    Description    (Table 0860)
  3959.  00h    BYTE    level (0 for DOS 4.x-6.0)
  3960.  01h    BYTE    reserved (0)
  3961.  02h    WORD    length of following data (14)
  3962.  04h    WORD    control flags
  3963.         bit 0 set for blink, clear for intensity
  3964.         bits 1-15 reserved
  3965.  06h    BYTE    mode type (1=text, 2=graphics)
  3966.  07h    BYTE    reserved (0)
  3967.  08h    WORD    colors
  3968.         0000h = monochrome
  3969.         else N bits per pixel
  3970.  0Ah    WORD    pixel columns
  3971.  0Ch    WORD    pixel rows
  3972.  0Eh    WORD    character columns
  3973.  10h    WORD    character rows
  3974.  
  3975. Format of parameter block for function 6Bh:
  3976. Offset    Size    Description    (Table 0861)
  3977.  00h    WORD    length of following data
  3978.  02h    WORD    number of hardware code pages
  3979.  04h  N WORDs    hardware code pages 1,...,N
  3980.     WORD    number of prepared code pages
  3981.       N WORDs    prepared code pages 1,...,N
  3982. --------d-21440C-----------------------------
  3983. INT 21 - Greg Shenaut ASPITAPE.SYS - INTERFACE
  3984.     AX = 440Ch
  3985.     BX = device handle
  3986.     CH = category code
  3987.         07h tape (ASPITAPE.SYS)
  3988.     CL = function
  3989.         01h "mtop" - perform tape operation
  3990.         02h "mtget" - get tape status
  3991.         03h ignore end-of-tape errors
  3992.         04h enable end-of-tape errors
  3993.     DS:DX -> parameter block (see #0862,#0863)
  3994. Return: CF set on error
  3995.         AX = error code (see #0980 at AH=59h)
  3996.     CF clear if successful
  3997.         DS:DX -> data block
  3998. Notes:    This device driver is a simple DOS interface to the Adaptec Advanced
  3999.       SCSI Programming Interface (ASPI).  It provides the following device
  4000.       names as access to the SCSI tape, 'RMTx' (rewind on close) and
  4001.       'NRMTx' (NO rewind on close) where x can go from 0 to 3.  There may
  4002.       also be the following names 'MTx' and 'NMTx' which default to 1024
  4003.       byte blocks.    The names may also have a '$' appended to try and make
  4004.       them unique from file names of 'RMT0' etc.
  4005.     once opend these devices must be put into RAW mode
  4006. SeeAlso: AX=4402h"ASPI"
  4007.  
  4008. Format of ASPITAPE.SYS mtop parameter block:
  4009. Offset    Size    Description    (Table 0862)
  4010.  00h    WORD    operation code
  4011.         00h "MTWEOF" - write an end-of-file record
  4012.         01h "MTFSF" - forward space file
  4013.         02h "MTBSF" - backward space file
  4014.         03h "MTFSR" - forward space record
  4015.         04h "MTBSR" - backward space record
  4016.         05h "MTREW" - rewind
  4017.         06h "MTOFFL" - rewind and unload
  4018.         07h "MTNOP" - perform TEST UNIT READY
  4019.  02h    DWORD    repetition count
  4020.  
  4021. Format of ASPITAPE.SYS mtget parameter block:
  4022. Offset    Size    Description    (Table 0863)
  4023.  00h    BYTE    ASPI host ID
  4024.  01h    BYTE    SCSI target ID
  4025.  02h    BYTE    SCSI logical unit number
  4026.  03h    BYTE    device parameters
  4027.         bit 0: drive must use fixed-block read and write
  4028.         bit 7: drive is an ASPI device
  4029.  04h    BYTE    current device state (see #0864)
  4030.  05h    BYTE    unit number within driver
  4031.  06h    WORD    fixed block blocksize
  4032.  08h    BYTE    last SCSI status
  4033.  09h    BYTE    last SCSI sense key
  4034.  0Ah    WORD    last SCSI opcode (packed) (see #0865)
  4035.  0Ch    WORD    residual bytes from SCSI opcode
  4036.  
  4037. Bitfields for ASPITAPE.SYS current device state:
  4038. Bit(s)    Description    (Table 0864)
  4039.  0    device currently opened in buffered mode
  4040.  1    drive currently opened in nonbuffered mode
  4041.  2    rewind drive on last close
  4042.  3    drive has been written on
  4043.  4    drive has been read from
  4044.  5    next read will return 0 bytes
  4045.  6    EOM will resemble EOF
  4046.  7    drive may be busy rewinding
  4047.  
  4048. Bitfields for SCSI opcode:
  4049. Bit(s)    Description    (Table 0865)
  4050.  0-7    SCSI operation (SCSI packet byte 0)
  4051.  8-10    SCSI flags (SCSI packet byte 1)
  4052.  11-12    ASPI "Direction Bits" (ASPI SRB byte 3)
  4053. --------D-21440D-----------------------------
  4054. INT 21 - DOS 3.2+ - IOCTL - GENERIC BLOCK DEVICE REQUEST
  4055.     AX = 440Dh
  4056.     BL = drive number (00h=default,01h=A:,etc)
  4057.     CH = category code (see #0866)
  4058.     CL = minor code (function) (see #0867)
  4059.     DS:DX -> (DOS) parameter block (see #0868,#0870,#0871,#0872,#0873)
  4060.     SI:DI -> (OS/2 comp box) parameter block (see #0874,#0876,#0877,#0880)
  4061. Return: CF set on error
  4062.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4063.     CF clear if successful
  4064.         DS:DX -> data block if CL=60h or CL=61h
  4065. Notes:    DOS 4.01 seems to ignore the high byte of the number of directory
  4066.       entries in the BPB for diskettes.
  4067.     functions 46h and 66h undocumented in DOS 4.x, documented for DOS 5+
  4068.     the DUBLDISK.SYS v2.6 driver only supports minor codes 60h and 67h
  4069.     DR DOS 3.41-6.0 only support minor codes 40h-42h and 60h-62h; all
  4070.       other minor codes return error code 16h
  4071.     some PCMCIA calls reportedly appear to be dangerous for MS-DOS versions
  4072.       prior to 5.0
  4073.     minor code 60h normally produces no I/O except with AutoMount=1 for
  4074.       DBLSPACE/DRVSPACE
  4075. SeeAlso: AX=440Ch,AX=440Dh/CX=084Ah,AX=440Dh/CX=0871h,AH=69h,INT 2F/AX=0802h
  4076. SeeAlso: INT 2F/AX=122Bh
  4077.  
  4078. (Table 0866)
  4079. Values for block device IOCTL category code:
  4080.  08h    disk drive
  4081.  00h-7Fh reserved for Microsoft
  4082.  80h-FFh reserved for OEM/user-defined
  4083.  
  4084. (Table 0867)
  4085. Values for generic block IOCTL minor code:
  4086.  00h    (OS/2)    \ used to lock/unlock a drive
  4087.  01h    (OS/2)    /
  4088.  40h    set device parameters (see #0868)
  4089.  41h    write logical device track (see #0870)
  4090.  42h    format and verify logical device track (see #0871)
  4091.  46h    (DOS 4.0+) set volume serial number (see #0873,AH=69h)
  4092.  47h    (DOS 4.0+) set access flag (see #0874)
  4093.  48h    (Enh. Disk Drive Spec) set media lock state (see #0875,INT 13/AH=45h)
  4094.  49h    (Enh. Disk Drive Spec) eject media in drive (see INT 13/AH=49h)
  4095.     no parameter block required
  4096.  4Ah    (MS-DOS 7.0) lock logical volume (see AX=440Dh/CX=084Ah)
  4097.  4Bh    (MS-DOS 7.0) lock physical volume (see AX=440Dh/CX=084Bh)
  4098.  50h    (PCMCIA) attribute memory write
  4099.  51h    (PCMCIA) common memory write
  4100.  52h    (PCMCIA) force media change (DOS 5+ ???) (see #0876)
  4101.  53h    (PCMCIA) erase drive
  4102.  54h    (PCMCIA) erase media
  4103.  56h    (PCMCIA) set erase status callback
  4104.  57h    (PCMCIA) append Card Information Structure (CIS) tuple
  4105.  58h    (PCMCIA) erase CIS tuples
  4106.  60h    get device parameters (see #0868)
  4107.  61h    read logical device track (see #0870)
  4108.  62h    verify logical device track (see #0872)
  4109.  66h    (DOS 4.0+) get volume serial number (see #0873,AH=69h)
  4110.  67h    (DOS 4.0+) get access flag (see #0874)
  4111.  68h    (DOS 5.0+) sense media type (see #0877)
  4112.  6Ah    (MS-DOS 7.0) unlock logical volume (see AX=440Dh/CX=086Ah)
  4113.     no parameter block required
  4114.  6Bh    (MS-DOS 7.0) unlock physical volume (see AX=440Dh/CX=086Bh)
  4115.     no parameter block required
  4116.  6Ch    (MS-DOS 7.0) get lock flag (see AX=440Dh/CX=086Ch)
  4117.     no parameter block required
  4118.  6Dh    (MS-DOS 7.0) enumerate open files (see AX=440Dh/CX=086Dh)
  4119.  6Eh    (MS-DOS 7.0) find swap file (see AX=440Dh/CX=086Eh)
  4120.  6Fh    (MS-DOS 7.0) get drive map information (see #0878)
  4121.  70h    (PCMCIA) attribute memory read
  4122.  70h    (MS-DOS 7.0) get current lock state (see AX=440Dh/CX=0870h)
  4123.     no parameter block required
  4124.  71h    (MS-DOS 7.0) get first cluster (see AX=440Dh/CX=0871h)
  4125.  73h    (PCMCIA) get memory media information (DOS 5+ ???) (see #0880)
  4126.  76h    (PCMCIA) get erase status callback
  4127.  77h    (PCMCIA) get first Card Information Structure (CIS) tuple
  4128.  78h    (PCMCIA) get next CIS tuple
  4129.  7Fh    (PCMCIA) get ??? information (see #0881,#0882)
  4130.  
  4131. Format of parameter block for functions 40h, 60h:
  4132. Offset    Size    Description    (Table 0868)
  4133.  00h    BYTE    special functions
  4134.         bit 0 set if function to use current BPB, clear if Device
  4135.               BIOS Parameter Block field contains new default BPB
  4136.         bit 1 set if function to use track layout fields only
  4137.             must be clear if CL=60h
  4138.         bit 2 set if all sectors in track same size (should be set)
  4139.         bits 3-7 reserved (MS-DOS, Novell DOS 7)
  4140.         bit 5: skip head settling time (WinDOS 2.11)
  4141.         bit 6: format access flag (WinDOS 2.11)
  4142.  01h    BYTE    device type (see #0869)
  4143.  02h    WORD    device attributes
  4144.         bit 0 set if nonremovable medium
  4145.         bit 1 set if door lock ("changeline") supported
  4146.         bits 2-15 reserved
  4147.  04h    WORD    number of cylinders
  4148.  06h    BYTE    media type
  4149.         for 1.2M drive
  4150.             00h 1.2M disk (default)
  4151.             01h 320K/360K disk
  4152.         F8h for DUBLDISK.SYS v2.6 expanded drives
  4153.         always 00h for other drive types
  4154.  07h 31 BYTEs    device BPB (see #0970 at AH=53h), bytes after BPB offset 1Eh
  4155.           omitted; final six bytes only transferred on function 40h
  4156.           with BYTE 00h bit 0 set for MS-DOS 5.0
  4157. ---function 40h only---
  4158.  26h    WORD    number of sectors per track (start of track layout field)
  4159.         (maximum 63)
  4160.  28h  N word pairs: number,size of each sector in track
  4161.  
  4162. (Table 0869)
  4163. Values for device type:
  4164.  00h    320K/360K disk
  4165.  01h    1.2M disk
  4166.  02h    720K disk
  4167.  03h    single-density 8-inch disk
  4168.  04h    double-density 8-inch disk
  4169.  05h    fixed disk
  4170.  06h    tape drive
  4171.  07h    (DOS 3.3+) other type of block device, normally 1.44M floppy
  4172.  08h    read/write optical disk
  4173.  09h    (DOS 5+) 2.88M floppy
  4174.  
  4175. Format of parameter block for functions 41h, 61h:
  4176. Offset    Size    Description    (Table 0870)
  4177.  00h    BYTE    special functions (reserved, must be zero)
  4178.  01h    WORD    number of disk head
  4179.  03h    WORD    number of disk cylinder
  4180.  05h    WORD    number of first sector to read/write
  4181.  07h    WORD    number of sectors
  4182.  09h    DWORD    transfer address
  4183. Note:    under Windows95, a volume must be locked (see AX=440Dh/CX=084Bh) in
  4184.       order to perform direct accesses such as track reads and writes
  4185.       with this IOCTL function
  4186.  
  4187. Format of parameter block for function 42h:
  4188. Offset    Size    Description    (Table 0871)
  4189.  00h    BYTE    reserved, must be zero (DOS <3.2)
  4190.           bit 0=0: format/verify track
  4191.             1: format status call (DOS 3.2+), don't actually format
  4192.           bit 1: format multiple tracks, require additional WORD
  4193.               (hard disks only)
  4194.           bits 2-7 reserved, must be zero
  4195.         value on return (DOS 3.3+):
  4196.           00h    specified tracks, sectors/track supported by BIOS
  4197.           01h    function not supported by BIOS
  4198.           02h    specified tracks, sectors/track not allowed for drive
  4199.           03h    no disk in drive
  4200.  01h    WORD    number of disk head
  4201.  03h    WORD    number of disk cylinder
  4202. ---BYTE 00h bit 1 set---
  4203.  05h    WORD    number of tracks to format
  4204.  
  4205. Format of parameter block for function 62h:
  4206. Offset    Size    Description    (Table 0872)
  4207.  00h    BYTE    reserved, must be zero (DOS <3.2)
  4208.           bit 0=0: verify single track
  4209.             1: verify multiple tracks
  4210.           bits 1-7 reserved, must be zero
  4211.         value on return (DOS 3.3+):
  4212.           00h    specified tracks, sectors/track supported by BIOS
  4213.           01h    function not supported by BIOS
  4214.           02h    specified tracks, sectors/track not allowed for drive
  4215.           03h    no disk in drive
  4216.  01h    WORD    number of disk head
  4217.  03h    WORD    number of disk cylinder
  4218.  05h    WORD    number of tracks to verify (equivalent to 255 or fewer sectors)
  4219.  
  4220. Format of parameter block for functions 46h, 66h:
  4221. Offset    Size    Description    (Table 0873)
  4222.  00h    WORD    (call) info level (should be 0000h)
  4223.  02h    DWORD    disk serial number (binary)
  4224.  06h 11 BYTEs    volume label or "NO NAME    "
  4225.  11h  8 BYTEs    filesystem type "FAT12     " or "FAT16   "
  4226.           (generally CL=66h only, but MS-DOS 5.0 will write the
  4227.           given filesystem type to the disk)
  4228.  
  4229. Format of parameter block for functions 47h, 67h:
  4230. Offset    Size    Description    (Table 0874)
  4231.  00h    BYTE    special-function field (must be zero)
  4232.  01h    BYTE    disk-access flag, nonzero if access allowed by driver
  4233.  
  4234. Format of parameter block for function 48h:
  4235. Offset    Size    Description    (Table 0875)
  4236.  00h    BYTE    (call) locking operation
  4237.         00h lock media in drive
  4238.         01h unlock media
  4239.         02h get locking status
  4240.  01h    BYTE    (ret) drive's lock status (number of pending locks on drive)
  4241. Note:    also supported by MS-DOS 7.0
  4242.  
  4243. Format of parameter block for function 52h:
  4244.  00h    BYTE    (call) unused???    (Table 0876)
  4245.         (ret) 00h if flash/ATA drive but no card inserted
  4246.             unchanged otherwise
  4247. Notes:    the absense of a flash card should be tested by checking the DOS error
  4248.       code rather than the returned byte
  4249.     the parameter byte is cleared to 00h erroneously by the Award
  4250.       PCDISK.EXE v1.02c PCMCIA/ATA driver if no ATA card is inserted
  4251.       (bug corrected in PCDISK.EXE v1.02h and later)
  4252.     not supported by the SystemSoft ATADRV.EXE and the Phoenix PCMATA.SYS
  4253.       PCMCIA/ATA drivers
  4254.  
  4255. Format of parameter block for function 68h:
  4256. Offset    Size    Description    (Table 0877)
  4257.  00h    BYTE    01h for default media type, 00h for any other media type
  4258.         (see also INT 13/AH=20h"Compaq")
  4259.  01h    BYTE    02h for 720K, 07h for 1.44M, 09h for 2.88M
  4260.  
  4261. Format of parameter block for function 6Fh:
  4262. Offset    Size    Description    (Table 0878)
  4263.  00h    BYTE    (call) length of this buffer (in bytes)
  4264.  01h    BYTE    (ret) number of bytes in parameter block actually used
  4265.  02h    BYTE    (ret) drive flags (see #0879)
  4266.  03h    BYTE    (ret) physical drive number
  4267.         00h-7Fh floppy
  4268.         80h-FEh hard
  4269.         FFh no physical drive
  4270.  04h    DWORD    (ret) bitmap of logical drives associated with physical drive
  4271.         bit 0 = drive A:, etc.
  4272.  08h    QWORD    (ret) relative block address of partition start
  4273.  
  4274. Bitfields for Get Drive Map Information drive flags:
  4275. Bit(s)    Description    (Table 0879)
  4276.  0    protected-mode driver for logical drive
  4277.  1    protected-mode driver in use for physical drive corresponding to the
  4278.       logical drive
  4279.  2    drive available only in protected mode
  4280.  3    protected-mode drive supports media ejection
  4281.  4    drive issues media insertion and removal notifications
  4282. SeeAlso: #0878
  4283.  
  4284. Format of parameter block for function 73h:
  4285. Offset    Size    Description    (Table 0880)
  4286.  00h    BYTE    ???
  4287.         00h ATA card inserted ???
  4288.         80h ATA card not inserted ???
  4289.  01h    BYTE    length of parameter block ???
  4290.         apparently always 40h
  4291.  02h    BYTE    ???
  4292.         00h ATA card not inserted ???
  4293.         0Dh ATA card inserted ???
  4294.  03h  2 BYTEs    ??? (apparently always 00h)
  4295.  05h    BYTE    drive number (0=first) ???
  4296.  06h    BYTE    total number of drives ???
  4297.  07h    BYTE    ???
  4298.         00h ATA card not inserted ???
  4299.         01h ATA card inserted ???
  4300.  08h 17 BYTEs    ???
  4301.  19h    BYTE    ???
  4302.         00h ATA card not inserted ???
  4303.         01h ATA card inserted ???
  4304.  1Ah    BYTE    ??? (apparently always 01h)
  4305.  1Bh    BYTE    ???
  4306.         00h ATA card not inserted ???
  4307.         01h ATA card inserted ???
  4308.  1Ch  2 BYTEs    ??? (apparently always 0015h)
  4309.  1Eh  2 BYTEs    ???
  4310.  20h  2 BYTEs    ??? (apparently always 0110h)
  4311.  22h 15 BYTEs    ???
  4312.  31h  2 BYTEs    ??? (apparently always 7000h)
  4313.  33h 11 BYTEs    driver signature
  4314.         "AWARD PDISK" for Award PCDISK.EXE PCMCIA/ATA driver
  4315.         "MS-BIOS    " for HP 200LX generic ATA driver
  4316.  3Eh  2 BYTEs    ???
  4317. Notes:    parameter structure possibly depends on driver
  4318.     this function is not supported by the SystemSoft ATADRV.EXE and the
  4319.       Phoenix PCMATA.SYS PCMCIA/ATA drivers
  4320.  
  4321. Format of parameter block for function 7Fh for SystemSoft ATADRV.EXE:
  4322. Offset    Size    Description    (Table 0881)
  4323.  00h    DWORD    -> unknown location within driver
  4324. Note:    function supported by the SystemSoft ATADRV.EXE PCMCIA/ATA driver
  4325.       but not by the Award PCDISK.EXE PCMCIA/ATA driver
  4326. SeeAlso: #0882
  4327.  
  4328. Format of parameter block for function 7Fh for Phoenix PCMATA.SYS:
  4329. Offset    Size    Description    (Table 0882)
  4330.  00h  8 BYTEs    ???
  4331. Note:    this function supported by the Phoenix PCMATA.SYS PCMCIA/ATA driver
  4332.       but not by the Award PCDISK.EXE PCMCIA/ATA driver
  4333. SeeAlso: #0881
  4334. --------D-21440DCX084A-----------------------
  4335. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - LOCK LOGICAL VOLUME
  4336.     AX = 440Dh
  4337.     CX = 084Ah (category code 08h, minor code 4Ah)
  4338.     BL = drive number (00h=default,01h=A:,etc)
  4339.     BH = lock level (00h-03h)
  4340.     DX = drive permissions (see #0883) for Level 1 lock or second
  4341.         Level 0 lock when formatting
  4342. Return: CF set on error
  4343.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4344.     CF clear if successful
  4345. Note:    the logical volume must be locked before direct disk accesses are
  4346.       permitted by Windows95
  4347. SeeAlso: AX=440Dh,AX=440Dh/CX=084Bh,AX=440Dh/CX=086Ah,AX=440Dh/CX=086Ch
  4348.  
  4349. Bitfields for drive permissions:
  4350. Bit(s)    Description    (Table 0883)
  4351.  0    allow writes
  4352.  1    disallow new file mappings
  4353.  2    volume locked for formatting
  4354. --------D-21440DCX084B-----------------------
  4355. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - LOCK PHYSICAL VOLUME
  4356.     AX = 440Dh
  4357.     CX = 084Bh (category code 08h, minor code 4Bh)
  4358.     BL = physical drive number (00h-7Fh = floppy, 80h-FFh = hard disk)
  4359.     BH = lock level (00h-03h)
  4360.     DX = drive permissions (see #0883) for Level 1 lock or second
  4361.         Level 0 lock when formatting
  4362. Return: CF set on error
  4363.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4364.     CF clear if successful
  4365. Note:    the physical volume must be locked before direct disk writes via
  4366.       INT 13 are permitted by Windows95
  4367. SeeAlso: AX=440Dh,AX=440Dh/CX=084Ah,AX=440Dh/CX=086Bh,AX=440Dh/CX=086Ch
  4368. --------D-21440DCX086A-----------------------
  4369. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - UNLOCK LOGICAL VOLUME
  4370.     AX = 440Dh
  4371.     CX = 086Ah (category code 08h, minor code 6Ah)
  4372.     BL = drive number (00h=default,01h=A:,etc)
  4373. Return: CF set on error
  4374.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4375.     CF clear if successful
  4376. Note:    the logical volume must be locked before direct disk accesses via
  4377.       INT 13 are permitted by Windows95
  4378. SeeAlso: AX=440Dh,AX=440Dh/CX=084Ah,AX=440Dh/CX=086Bh
  4379. --------D-21440DCX086B-----------------------
  4380. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - UNLOCK PHYSICAL VOLUME
  4381.     AX = 440Dh
  4382.     CX = 086Bh (category code 08h, minor code 6Bh)
  4383.     BL = physical drive number (00h-7Fh = floppy, 80h-FFh = hard disk)
  4384. Return: CF set on error
  4385.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4386.     CF clear if successful
  4387. SeeAlso: AX=440Dh,AX=440Dh/CX=084Bh,AX=440Dh/CX=086Ah
  4388. --------D-21440DCX086C-----------------------
  4389. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - GET LOCK FLAG STATE
  4390.     AX = 440Dh
  4391.     CX = 086Ch (category code 08h, minor code 6Ch)
  4392.     BL = drive number (00h=default,01h=A:,etc)
  4393. Return: CF set on error
  4394.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4395.     CF clear if successful
  4396.         AX = access flag (see #0884)
  4397. SeeAlso: AX=440Dh,AX=440Dh/CX=084Ah,AX=440Dh/CX=084Bh,AX=440Dh/CX=0870h
  4398.  
  4399. (Table 0884)
  4400. Values for drive access flag:
  4401.  0000h    no writes/file mappings since last call
  4402.  0001h    write operation has occurred since last call
  4403.  0002h    file mapping has occurred since last call
  4404. Note:    function 6Ch resets the access flag every time it is called
  4405. --------D-21440DCX086D-----------------------
  4406. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - ENUMERATE OPEN FILES
  4407.     AX = 440Dh
  4408.     CX = 086Dh (category code 08h, minor code 6Dh)
  4409.     BL = drive number (00h=default,01h=A:,etc)
  4410.     DS:DX -> buffer for ASCIZ pathname
  4411.     SI = file index (0000h to number of open files-1)
  4412.     DI = enumeration type (0000h all files, 0001h unmovable files)
  4413. Return: CF set on error
  4414.         AX = error code (01h,02h,12h,etc.) (see #0980 at AH=59h)
  4415.         0012h if file index is out of range
  4416.     CF clear if successful
  4417.         AX = file open mode (BX from AX=6C00h or AX=716Ch)
  4418.         CX = file type (see #0885)
  4419. SeeAlso: AX=440Dh,AX=440Dh/CX=084Ah,AX=440Dh/CX=086Ch,AX=440Dh/CX=086Eh
  4420. SeeAlso: AX=6C00h,AX=716Ch
  4421.  
  4422. (Table 0885)
  4423. Values for file type:
  4424.  0000h    normal file
  4425.  0001h    memory-mapped file (unmovable)
  4426.  0002h    unmovable file
  4427.  0004h    swap file
  4428. --------D-21440DCX086E-----------------------
  4429. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - FIND SWAP FILE
  4430.     AX = 440Dh
  4431.     CX = 086Eh (category code 08h, minor code 6Eh)
  4432.     BL = drive number (00h=default,01h=A:,etc)
  4433.     DS:DX -> buffer for ASCIZ pathname
  4434.     SI = file index
  4435.     DI = enumeration type
  4436. Return: CF set on error
  4437.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4438.     CF clear if successful
  4439.         AX = pager type
  4440.         0001h no pager
  4441.         0002h paging through MS-DOS
  4442.         0003h protected-mode pager
  4443.         CX:BX = swap file size in 4K pages
  4444. SeeAlso: AX=440Dh,AX=440Dh/CX=086Dh
  4445. --------D-21440DCX0870-----------------------
  4446. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - GET CURRENT LOCK STATE
  4447.     AX = 440Dh
  4448.     CX = 0870h (category code 08h, minor code 70h)
  4449.     BL = drive number (00h=default,01h=A:,etc)
  4450. Return: CF set on error
  4451.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4452.     CF clear if successful
  4453.         AX = current lock level (0-3) or FFFFh if not locked
  4454.         CX = lock permissions if AX<>FFFFh (see #0883)
  4455. SeeAlso: AX=440Dh,AX=440Dh/CX=086Ch
  4456. --------D-21440DCX0871-----------------------
  4457. INT 21 - MS-DOS 7.0 - GENERIC IOCTL - GET FIRST CLUSTER
  4458.     AX = 440Dh
  4459.     CX = 0871h (category code 08h, minor code 71h)
  4460.     BX = filename character set (see #0886)
  4461.     DS:DX -> ASCIZ pathname for file or directory
  4462. Return: CF set on error
  4463.         AX = error code (01h,02h,etc.) (see #0980 at AH=59h)
  4464.     CF clear if successful
  4465.         DX:AX = first cluster number
  4466. Note:    this function finds any file or directory regardless of attributes,
  4467.       except that it will not find volume labels
  4468. SeeAlso: AX=440Dh,AX=440Dh/CX=086Ch,#0668
  4469.  
  4470. (Table 0886)
  4471. Values for character set:
  4472.  00h    Windows ANSI
  4473.  01h    current OEM character set
  4474.  02h    Unicode
  4475. --------D-21440E-----------------------------
  4476. INT 21 - DOS 3.2+ - IOCTL - GET LOGICAL DRIVE MAP
  4477.     AX = 440Eh
  4478.     BL = drive number (00h=default,01h=A:,etc)
  4479. Return: CF set on error
  4480.         AX = error code (01h,0Fh) (see #0980 at AH=59h)
  4481.     CF clear if successful
  4482.         AL = 00h block device has only one logical drive assigned
  4483.          1..26 the last letter used to reference the drive (1=A:,etc)
  4484. Notes:    DR DOS 3.41-5.0 DRIVER.SYS does not support drive mapping and thus
  4485.       always returns AL=00h
  4486.     in addition to the normal operation, if Stacker is installed, this
  4487.       call also sets the volume number at offset 58h in the Stacker
  4488.       device driver (DR DOS 3.41-5.0 only; use AX=4408h otherwise)
  4489.       (see AX=4404h"Stacker",INT 25/AX=CDCDh)
  4490. SeeAlso: AX=4408h,AX=440Fh,INT 2F/AX=122Bh
  4491. --------D-21440F-----------------------------
  4492. INT 21 - DOS 3.2+ - IOCTL - SET LOGICAL DRIVE MAP
  4493.     AX = 440Fh
  4494.     BL = physical drive number (00h=default,01h=A:,etc))
  4495. Return: CF set on error
  4496.         AX = error code (01h,0Fh) (see #0980 at AH=59h)
  4497.     CF clear if successful
  4498.         drive now responds to next logical drive number
  4499. Notes:    maps logical drives to physical drives, similar to DOS's treatment of
  4500.       a single physical floppy drive as both A: and B:
  4501.     DR DOS 3.41-5.0 DRIVER.SYS does not support drive mapping and thus
  4502.       always returns an error on this function
  4503. SeeAlso: AX=440Eh,INT 2F/AX=122Bh
  4504. --------D-214410-----------------------------
  4505. INT 21 - DOS 5+ - IOCTL - QUERY GENERIC IOCTL CAPABILITY (HANDLE)
  4506.     AX = 4410h
  4507.     BX = handle for device
  4508.     CH = category code (see #0853)
  4509.     CL = function code (see #0854)
  4510. Return: CF clear if successful
  4511.         AX = 0000h    specified IOCTL function is supported
  4512.     CF set on error
  4513.         AL = 01h    IOCTL capability not available
  4514. Note:    a program which wishes to use Generic IOCTL calls beyond those in the
  4515.       standard DOS 3.2 set may use this call first to see whether a
  4516.       particular call is supported
  4517. SeeAlso: AX=440Ch,AX=440Dh,AX=4411h
  4518. --------d-214410BXFFFF-----------------------
  4519. INT 21 U - NewSpace - ENABLE DRIVER
  4520.     AX = 4410h
  4521.     BX = FFFFh
  4522. Program: NewSpace is a TSR by Isogon Corporation which automatically compresses
  4523.       all files as they are written and decompresses them as they are read
  4524. Note:    compressed files are not accessible unless the driver is enabled
  4525. SeeAlso: AX=4411h/BX=FFFFh
  4526. --------D-214411-----------------------------
  4527. INT 21 - DOS 5+ - IOCTL - QUERY GENERIC IOCTL CAPABILITY (DRIVE)
  4528.     AX = 4411h
  4529.     BL = drive number
  4530.     CH = category code (see #0866)
  4531.     CL = function code (see #0867)
  4532. Return: CF clear if successful
  4533.         AX = 0000h    specified IOCTL function is supported
  4534.     CF set on error
  4535.         AL = 01h    IOCTL capability not available
  4536. Note:    a program which wishes to use Generic IOCTL calls beyond those in the
  4537.       standard DOS 3.2 set may use this call first to see whether a
  4538.       particular call is supported
  4539. SeeAlso: AX=440Ch,AX=440Dh,AX=4410h
  4540. --------d-214411BXFFFF-----------------------
  4541. INT 21 U - NewSpace - DISABLE DRIVER
  4542.     AX = 4411h
  4543.     BX = FFFFh
  4544. Program: NewSpace is a TSR by Isogon Corporation which automatically compresses
  4545.       all files as they are written and decompresses them as they are read
  4546. Note:    compressed files are not accessible unless the driver is enabled
  4547. SeeAlso: AX=4410h/BX=FFFFh
  4548. --------O-214412-----------------------------
  4549. INT 21 O - DR DOS 5.0-6.0 - DETERMINE DOS TYPE
  4550.     AX = 4412h
  4551.     CF set
  4552. Return: CF set if not DR DOS
  4553.         AX = error code (see #0980 at AH=59h)
  4554.     CF clear if DR DOS
  4555.         DX = AX = version code (see #0888)
  4556. Note:    this obsolete call, which is no longer supported in Novell DOS 7, is
  4557.       identical to AX=4452h
  4558. SeeAlso: AX=4452h
  4559. --------d-214412BXFFFF-----------------------
  4560. INT 21 U - NewSpace - INSTALLATION CHECK???
  4561.     AX = 4412h
  4562.     BX = FFFFh
  4563. Return: AX = PSP segment of NewRes (resident driver for NewSpace)
  4564.     BX:DX -> ???
  4565.     CX = ???
  4566. SeeAlso: AX=4411h/BX=FFFFh
  4567. --------d-214413BXFFFF-----------------------
  4568. INT 21 U - NewSpace - GET ???
  4569.     AX = 4413h
  4570.     BX = FFFFh
  4571. Return: AX = code segment of NewRes (resident driver for NewSpace)
  4572.     BX = offset of ???
  4573. SeeAlso: AX=4412h/BX=FFFFh
  4574. --------O-214414-----------------------------
  4575. INT 21 OU - DR DOS 5.0-6.0 - SET GLOBAL PASSWORD
  4576.     AX = 4414h
  4577.     DS:DX -> password string (blank-padded to 8 characters)
  4578. Desc:    Specify the master password for accessing files.
  4579. Note:    this obsolete call, which is no longer supported in Novell DOS 7, is
  4580.       identical to AX=4454h
  4581. SeeAlso: AX=4454h
  4582. --------d-214414BXFFFF-----------------------
  4583. INT 21 U - NewSpace - DEBUGGING DUMP
  4584.     AX = 4414h
  4585.     BX = FFFFh
  4586. Return: debugging dump written to X:\NEWSPACE.SMP
  4587. SeeAlso: AX=4413h/BX=FFFFh,AX=44FFh/BX=FFFFh
  4588. --------O-2144-------------------------------
  4589. INT 21 OU - DR DOS 5.0-6.0 - HISTORY BUFFER, SHARE, AND HILOAD CONTROL
  4590.     AH = 44h
  4591.     AL = 16h to 18h
  4592. Note:    these obsolete subfunctions (which are no longer supported in Novell
  4593.       DOS 7) are identical to AX=4456h through 4458h
  4594. SeeAlso: AX=4456h,AX=4457h,AX=4458h
  4595. --------O-214451-----------------------------
  4596. INT 21 - Concurrent DOS v3.2+ - INSTALLATION CHECK
  4597.     AX = 4451h
  4598. Return: CF set if not Concurrent DOS
  4599.         AX = error code (see #0980 at AH=59h)
  4600.     CF clear if successful
  4601.         AH = single-user/multiuser nature
  4602.         10h single-user
  4603.             AL = operating system version ID (see #0888)
  4604.         14h multiuser
  4605.             AL = operating system version ID (see #0887)
  4606. Notes:    as of Concurrent DOS/XM 5.0 (possibly earlier), the version is stored
  4607.       in the environment variable VER
  4608.     use this function if you are looking for multiuser capabilities,
  4609.       AX=4452h for single-user
  4610.     this function should never return the single-user values
  4611. SeeAlso: AX=4452h,AX=4459h
  4612.  
  4613. (Table 0887)
  4614. Values for Digital Research operating system version ID:
  4615.  32h    Concurrent PC DOS 3.2
  4616.  41h    Concurrent DOS 4.1
  4617.  50h    Concurrent DOS/XM 5.0 or Concurrent DOS/386 1.1
  4618.  60h    Concurrent DOS/XM 6.0 or Concurrent DOS/386 2.0
  4619.  62h    Concurrent DOS/XM 6.2 or Concurrent DOS/386 3.0
  4620.  66h    DR Multiuser DOS 5.1
  4621.  67h    Concurrent DOS 5.1
  4622. --------O-214452-----------------------------
  4623. INT 21 - DR DOS 3.41+ - DETERMINE DOS TYPE/GET DR DOS VERSION
  4624.     AX = 4452h ("DR")
  4625.     CF set
  4626. Return: CF set if not DR DOS
  4627.         AX = error code (see #0980 at AH=59h)
  4628.     CF clear if DR DOS
  4629.         AX = version code
  4630.         AH = single-user/multiuser nature
  4631.         10h single-user
  4632.             AL = operating system version ID (see #0888)
  4633.         14h multiuser
  4634.             AL = operating system version ID (see #0887)
  4635.         DX modified (see note)
  4636. Notes:    the DR DOS version is stored in the environment variable VER
  4637.     use this function if looking for single-user capabilities, AX=4451h
  4638.       if looking for multiuser; this call should never return multiuser
  4639.       values
  4640.     in DR DOS 3.41-6.0, DX=AX on return; for Novell DOS 7, DH=AH but DL=00h
  4641.       (reportedly, DH=00h when booting NWDOS7 from installation disks)
  4642.     Novell DOS 7 returns error code 0001h if SETVER 255.x is in effect for
  4643.       the calling program
  4644. SeeAlso: AX=4412h,AX=4451h,AX=4459h
  4645.  
  4646. (Table 0888)
  4647. Values for Digital Research operating system version ID:
  4648.  60h    DOS Plus
  4649.  63h    DR DOS 3.41
  4650.  64h    DR DOS 3.42
  4651.  65h    DR DOS 5.00
  4652.  67h    DR DOS 6.00
  4653.  70h    PalmDOS
  4654.  71h    DR DOS 6.0 March 1993 "business update"
  4655.  72h    Novell DOS 7.0
  4656. --------O-214454-----------------------------
  4657. INT 21 U - DR DOS 3.41+ - SET GLOBAL PASSWORD
  4658.     AX = 4454h
  4659.     DS:DX -> password string (blank-padded to 8 characters)
  4660. Desc:    Specify the master password for accessing files.
  4661. SeeAlso: AX=4303h,AX=4414h
  4662. --------O-214456-----------------------------
  4663. INT 21 U - DR DOS 5.0+ - HISTORY BUFFER CONTROL
  4664.     AX = 4456h
  4665.     DL = control flags (see #0889)
  4666. Return: AL = previous value of state flags (see #0890)
  4667. Note:    DR DOS 6.0 only checks bit 0 and ignores the rest of DL
  4668. SeeAlso: #0891
  4669.  
  4670. Bitfields for control flags:
  4671. Bit(s)    Description    (Table 0889)
  4672.  0    whose buffer: 0=application, 1=COMMAND.COM
  4673. ---Novell DOS 7---
  4674.  1    toggle HISTORY usage
  4675.  2    toggle INSERT state
  4676. Note:    only one bit at a time may be used
  4677.  
  4678. Bitfields for state flags:
  4679. Bit(s)    Description    (Table 0890)
  4680.  0    HISTORY buffer enabled
  4681.  1    INSERT enabled
  4682.  2-5    unused
  4683.  7    whose buffer: 0=application, 1=COMMAND.COM
  4684. --------O-214457-----------------------------
  4685. INT 21 U - DR DOS 5.0-6.0 - SHARE/HILOAD CONTROL
  4686.     AX = 4457h
  4687.     DH = subfunction
  4688.         00h enable/disable SHARE
  4689.         DL = 00h disable
  4690.            = 01h enable
  4691.            else Return: AX = ???
  4692.         01h get HILOAD status
  4693.         Return: AX = status
  4694.                 0000h off
  4695.                 0001h on
  4696.         02h set HILOAD status
  4697.         DL = new state (00h off, 01h on)
  4698.         Return: AX = ???
  4699.         other
  4700.         Return: AX = ???
  4701. Note:    This was seen called by COMMAND.COM of DR DOS 6.0; it does not seem
  4702.       to be supported by Novell DOS 7
  4703. SeeAlso: AX=4457h/DX=FFFFh
  4704. --------O-214457DXFFFF-----------------------
  4705. INT 21 U - DR DOS 6.0 - GET SHARE STATUS
  4706.     AX = 4457h
  4707.     DX = FFFFh
  4708. Return: AX = SHARE status
  4709. SeeAlso: INT 2F/AX=1000h
  4710. --------O-214458-----------------------------
  4711. INT 21 U - DR DOS 5.0+ internal - GET POINTER TO INTERNAL VARIABLE TABLE
  4712.     AX = 4458h
  4713. Return: ES:BX -> internal variable table (see #0891,#0892)
  4714.     AX = ??? (0B50h for DR DOS 5.0, 0A56h for DR DOS 6.0, 0FE4h for
  4715.           Novell DOS 7)
  4716. SeeAlso: AX=4452h
  4717.  
  4718. Format of DR DOS 5.0-6.0 internal variable table:
  4719. Offset    Size    Description    (Table 0891)
  4720.  00h    WORD    ???
  4721.  02h    WORD    segment of ???
  4722.  04h    WORD    offset within DOS data segment of history control structure
  4723.           for COMMAND.COM history buffer (see #0893)
  4724.  06h    WORD    offset within DOS data segment of history control structure
  4725.           for application history buffer (see #0893)
  4726.  08h    BYTE    initial history state flags (see #0890)
  4727.  09h  2 BYTEs    ???
  4728.  0Bh    WORD    KB of extended memory at startup
  4729.  0Dh    BYTE    number of far jump entry points
  4730.  0Eh    WORD    segment containing far jumps to DR DOS entry points (see #0894)
  4731.  10h    WORD    (only if kernel loaded in HMA) offset in HMA of first free HMA
  4732.           memory block (see #0895) or 0000h if none; segment is FFFFh
  4733.  12h    WORD    pointer to segment of environment variables set in CONFIG,
  4734.           or 0000h if already used
  4735. ---DR DOS 6.0---
  4736.  14h    WORD    (only if kernel loaded in HMA) offset in HMA of first used HMA
  4737.         memory block (see #0895) or 0000h if none; segment is FFFFh
  4738.  16h  8 BYTEs    ???
  4739.  1Eh    WORD    offset in DOS data segment of full COUNTRY.SYS filename
  4740.  20h  8 BYTEs    ???
  4741.  28h    WORD    offset in DOS data segment of SHARE hook table
  4742.  2Ah  2 BYTEs    ???
  4743.  2Ch    WORD    offset in DOS data segment of far pointer to INT 2F/AX=1000h
  4744.           handler
  4745. Note:    the segment used for the DR DOS 6.0 CONFIG environment variables
  4746.       (excluding COMSPEC, VER and OS) is only useful for programs/drivers
  4747.       called from CONFIG.SYS. The word is set to zero later when the area
  4748.       is copied to the COMMAND.COM environment space.  This allows
  4749.       CONFIG.SYS to pass information to AUTOEXEC.BAT.
  4750.  
  4751. Format of Novell DOS 7 internal variable table:
  4752. Offset    Size    Description    (Table 0892)
  4753.  00h    ???
  4754.  1Eh    WORD    offset of COUNTRY.SYS filename
  4755.  42h 16 DWORDs    pointers to ??? entry points
  4756.     ???
  4757.  
  4758. Format of history control structure:
  4759. Offset    Size    Description    (Table 0893)
  4760.  00h    WORD    segment of buffer
  4761.  02h    WORD    size of buffer in bytes
  4762.  04h    WORD    ???
  4763.  
  4764. Format of kernel entry jump table for DR DOS 5.0-6.0:
  4765. Offset    Size    Description    (Table 0894)
  4766.  00h  5 BYTEs    far jump to kernel entry point for CP/M CALL 5
  4767.  05h  5 BYTEs    far jump to kernel entry point for INT 20
  4768.  0Ah  5 BYTEs    far jump to kernel entry point for INT 21
  4769.  0Fh  5 BYTEs    far jump to kernel entry point for INT 22 (RETF)
  4770.  14h  5 BYTEs    far jump to kernel entry point for INT 23 (RETF)
  4771.  19h  5 BYTEs    far jump to kernel entry point for INT 24
  4772.  1Eh  5 BYTEs    far jump to kernel entry point for INT 25
  4773.  23h  5 BYTEs    far jump to kernel entry point for INT 26
  4774.  28h  5 BYTEs    far jump to kernel entry point for INT 27
  4775.  2Dh  5 BYTEs    far jump to kernel entry point for INT 28
  4776.  32h  5 BYTEs    far jump to kernel entry point for INT 2A (IRET)
  4777.  37h  5 BYTEs    far jump to kernel entry point for INT 2B (IRET)
  4778.  3Ch  5 BYTEs    far jump to kernel entry point for INT 2C (IRET)
  4779.  41h  5 BYTEs    far jump to kernel entry point for INT 2D (IRET)
  4780.  46h  5 BYTEs    far jump to kernel entry point for INT 2E (IRET)
  4781.  4Bh  5 BYTEs    far jump to kernel entry point for INT 2F
  4782. Notes:    all of these entry points are indirected through this jump table
  4783.       to allow the kernel to be relocated into high memory while leaving
  4784.       the actual entry addresses in low memory for maximum compatibility
  4785.     some of these entry points (22h,23h,24h,2Eh,2Fh) are replaced as soon
  4786.       as COMMAND.COM is loaded, and return immediately to the caller, some
  4787.       returning an error code (the original handler for INT 2F returns
  4788.       AL=03h [fail]).
  4789.  
  4790. Format of HMA Memory Block (DR DOS 6.0 kernel loaded in HMA):
  4791. Offset    Size    Description    (Table 0895)
  4792.  00h    WORD    offset of next HMA Memory Block (0000h if last block)
  4793.  02h    WORD    size of this block in bytes (at least 10h)
  4794.  04h    BYTE    type of HMA Memory Block (interpreted by MEM)
  4795.         00h system
  4796.         01h KEYB
  4797.         02h NLSFUNC
  4798.         03h SHARE
  4799.         04h TaskMAX
  4800.         05h COMMAND
  4801.  05h    var    TSR (or system) code and data. DR DOS TSR's, such as KEYB,
  4802.           hooks interrupts using segment FFFEh instead FFFFh.
  4803. --------O-214459-----------------------------
  4804. INT 21 - DR MultiUser DOS 5.0 - API
  4805.     AX = 4459h
  4806.     CL = function (see #3190 at INT E0"CP/M")
  4807.     DS,DX = parameters
  4808. Notes:    DR DOS 5.0 and Novell DOS 7 return CF set and AX=0001h
  4809.     this API is also available on INT E0
  4810. SeeAlso: AX=4452h,INT E0"CP/M"
  4811. --------v-2144A0-----------------------------
  4812. INT 21 - VIRUS - "Horns" - INSTALLATION CHECK
  4813.     AX = 44A0h
  4814. Return: AH = FFh if installed
  4815. SeeAlso: AX=4243h"VIRUS",AX=4B04h"VIRUS"
  4816. --------N-2144E0-----------------------------
  4817. INT 21 U - Sun PC-NFS - API???
  4818.     AX = 44E0h
  4819.     DS:DX -> ???
  4820.     SS:BP -> stack frame (see #0896)
  4821. Return: ???
  4822. Note:    this function is also supported by Beame&Whiteside's BWPCNFS shim; the
  4823.       description presented here was derived from that shim
  4824.  
  4825. Format of PC-NFS stack frame:
  4826. Offset    Size    Description    (Table 0896)
  4827.  00h    WORD    -> previous stack frame
  4828.  02h    DWORD    return address
  4829. --------d-2144FFBXFFFF-----------------------
  4830. INT 21 U - NewSpace - ???
  4831.     AX = 44FFh
  4832.     BX = FFFFh
  4833.     DX = ???
  4834. Program: NewSpace is a TSR by Isogon Corporation which automatically compresses
  4835.       all files as they are written and decompresses them as they are read
  4836. SeeAlso: AX=4414h/BX=FFFFh
  4837. --------D-2145-------------------------------
  4838. INT 21 - DOS 2+ - "DUP" - DUPLICATE FILE HANDLE
  4839.     AH = 45h
  4840.     BX = file handle
  4841. Return: CF clear if successful
  4842.         AX = new handle
  4843.     CF set on error
  4844.         AX = error code (04h,06h) (see #0980 at AH=59h)
  4845. Notes:    moving file pointer for either handle will also move it for the other,
  4846.       because both will refer to the same system file table
  4847.     for DOS versions prior to 3.3, file writes may be forced to disk by
  4848.       duplicating the file handle and closing the duplicate
  4849. SeeAlso: AH=3Dh,AH=46h
  4850. --------D-2146-------------------------------
  4851. INT 21 - DOS 2+ - "DUP2", "FORCEDUP" - FORCE DUPLICATE FILE HANDLE
  4852.     AH = 46h
  4853.     BX = file handle
  4854.     CX = file handle to become duplicate of first handle
  4855. Return: CF clear if successful
  4856.     CF set on error
  4857.         AX = error code (04h,06h) (see #0980 at AH=59h)
  4858. Notes:    closes file with handle CX if it is still open
  4859.     DOS 3.30 hangs if BX=CX on entry
  4860.     moving file pointer for either handle will also move it for the other,
  4861.       because both will refer to the same system file table
  4862. SeeAlso: AH=3Dh,AH=45h
  4863. --------D-2147-------------------------------
  4864. INT 21 - DOS 2+ - "CWD" - GET CURRENT DIRECTORY
  4865.     AH = 47h
  4866.     DL = drive number (00h = default, 01h = A:, etc)
  4867.     DS:SI -> 64-byte buffer for ASCIZ pathname
  4868. Return: CF clear if successful
  4869.         AX = 0100h (undocumented)
  4870.     CF set on error
  4871.         AX = error code (0Fh) (see #0980 at AH=59h)
  4872. Notes:    the returned path does not include a drive or the initial backslash
  4873.     many Microsoft products for Windows rely on AX being 0100h on success
  4874.     under the FlashTek X-32 DOS extender, the buffer pointer is in DS:ESI
  4875. SeeAlso: AH=19h,AH=3Bh,AH=71h,INT 15/AX=DE25h
  4876. --------D-2148-------------------------------
  4877. INT 21 - DOS 2+ - ALLOCATE MEMORY
  4878.     AH = 48h
  4879.     BX = number of paragraphs to allocate
  4880. Return: CF clear if successful
  4881.         AX = segment of allocated block
  4882.     CF set on error
  4883.         AX = error code (07h,08h) (see #0980 at AH=59h)
  4884.         BX = size of largest available block
  4885. Notes:    DOS 2.1-6.0 coalesces free blocks while scanning for a block to
  4886.       allocate
  4887.     .COM programs are initially allocated the largest available memory
  4888.       block, and should free some memory with AH=49h before attempting any
  4889.       allocations
  4890.     under the FlashTek X-32 DOS extender, EBX contains a protected-mode
  4891.       near pointer to the allocated block on a successful return
  4892. SeeAlso: AH=49h,AH=4Ah,AH=58h,AH=83h
  4893. --------D-2149-------------------------------
  4894. INT 21 - DOS 2+ - FREE MEMORY
  4895.     AH = 49h
  4896.     ES = segment of block to free
  4897. Return: CF clear if successful
  4898.     CF set on error
  4899.         AX = error code (07h,09h) (see #0980 at AH=59h)
  4900. Notes:    apparently never returns an error 07h, despite official docs; DOS 2.1+
  4901.       code contains only an error 09h exit
  4902.     DOS 2.1-6.0 does not coalesce adjacent free blocks when a block is
  4903.       freed, only when a block is allocated or resized
  4904.     the code for this function is identical in DOS 2.1-6.0 except for
  4905.       calls to start/end a critical section in DOS 3.0+
  4906. SeeAlso: AH=48h,AH=4Ah
  4907. --------D-214A-------------------------------
  4908. INT 21 - DOS 2+ - RESIZE MEMORY BLOCK
  4909.     AH = 4Ah
  4910.     BX = new size in paragraphs
  4911.     ES = segment of block to resize
  4912. Return: CF clear if successful
  4913.     CF set on error
  4914.         AX = error code (07h,08h,09h) (see #0980 at AH=59h)
  4915.         BX = maximum paragraphs available for specified memory block
  4916. Notes:    under DOS 2.1-6.0, if there is insufficient memory to expand the block
  4917.       as much as requested, the block will be made as large as possible
  4918.     DOS 2.1-6.0 coalesces any free blocks immediately following the block
  4919.       to be resized
  4920. SeeAlso: AH=48h,AH=49h,AH=83h
  4921. --------v-214A--BX00B6-----------------------
  4922. INT 21 - VIRUS???
  4923.     AH = 4Ah
  4924.     BX = 00B6h
  4925.     ES = CX
  4926. Return: ???
  4927. Note:    this call is intercepted by the Search&Destroy SDRes v27.03 bundled
  4928.       with Novell DOS 7, and is presumably some virus's installation check
  4929. SeeAlso: AH=0Eh/DL=ADh,AH=4Ah/BX=FFFFh,AH=D2h"VIRUS"
  4930. --------v-214A--BXFFFF-----------------------
  4931. INT 21 - VIRUS???
  4932.     AH = 4Ah
  4933.     BX = FFFFh
  4934.     CX = 0568h
  4935.     SI = 0129h
  4936.     DI = 0000h
  4937.     ES = BP
  4938. Return: ???
  4939. Note:    this call is intercepted by the Search&Destroy SDRes v27.03 bundled
  4940.       with Novell DOS 7, and is presumably some virus's installation check
  4941. SeeAlso: AH=0Eh/DL=ADh,AH=4Ah/BX=00B6h
  4942. --------D-214B-------------------------------
  4943. INT 21 - DOS 2+ - "EXEC" - LOAD AND/OR EXECUTE PROGRAM
  4944.     AH = 4Bh
  4945.     AL = type of load
  4946.         00h load and execute
  4947.         01h load but do not execute
  4948.         03h load overlay (see #0898)
  4949.         04h load and execute in background (European MS-DOS 4.0 only)
  4950.         "Exec & Go" (see also AH=80h)
  4951.     DS:DX -> ASCIZ program name (must include extension)
  4952.     ES:BX -> parameter block (see #0897,#0898,#0899)
  4953.     CX = mode (subfunction 04h only)
  4954.         0000h child placed in zombie mode after termination
  4955.         0001h child's return code discarded on termination
  4956. Return: CF clear if successful
  4957.         BX,DX destroyed
  4958.         if subfunction 01h, process ID set to new program's PSP; get with
  4959.         INT 21/AH=62h
  4960.     CF set on error
  4961.         AX = error code (01h,02h,05h,08h,0Ah,0Bh) (see #0980 at AH=59h)
  4962. Notes:    DOS 2.x destroys all registers, including SS:SP
  4963.     under ROM-based DOS, if no disk path characters (colons or slashes)
  4964.       are included in the program name, the name is searched for in the
  4965.       ROM module headers (see #0902) before searching on disk
  4966.     for functions 00h and 01h, the calling process must ensure that there
  4967.       is enough unallocated memory available; if necessary, by releasing
  4968.       memory with AH=49h or AH=4Ah
  4969.     for function 01h, the AX value to be passed to the child program is put
  4970.       on top of the child's stack
  4971.     for function 03h, DOS assumes that the overlay is being loaded into
  4972.       memory allocated by the caller
  4973.     function 01h was undocumented prior to the release of DOS 5.0
  4974.     some versions (such as DR DOS 6.0) check the parameters and parameter
  4975.       block and return an error if an invalid value (such as an offset of
  4976.       FFFFh) is found
  4977.     background programs under European MS-DOS 4.0 must use the new
  4978.       executable format
  4979.     this function ignores the filename extension, instead checking the
  4980.       first two bytes of the file to determine whether there is a valid
  4981.       .EXE header (see #0901); if not, the file is assumed to be in .COM
  4982.       format.  If present, the file may be in any of several formats which
  4983.       are extensions of the original .EXE format (see #0900)
  4984.     .COM-format executables begin running with the following register
  4985.       values:
  4986.         AL = 00h if first FCB has valid drive letter, FFh if not
  4987.         AH = 00h if second FCB has valid drive letter, FFh if not
  4988.         CS,DS,ES,SS = PSP segment
  4989.         SP = offset of last word available in first 64K segment
  4990.         (note: AX is always 0000h under DESQview)
  4991.     old-format executables begin running with the following register
  4992.       values:
  4993.         AL = 00h if first FCB has valid drive letter, FFh if not
  4994.         AH = 00h if second FCB has valid drive letter, FFh if not
  4995.         DS,ES = PSP segment
  4996.         SS:SP as defined in .EXE header
  4997.         (note: AX is always 0000h under DESQview)
  4998.     new executables begin running with the following register values
  4999.         AX = environment segment
  5000.         BX = offset of command tail in environment segment
  5001.         CX = size of automatic data segment (0000h = 64K)
  5002.         ES,BP = 0000h
  5003.         DS = automatic data segment
  5004.         SS:SP = initial stack
  5005.       the command tail corresponds to an old executable's PSP:0081h and
  5006.       following, except that the 0Dh is turned into a NUL (00h); new
  5007.       format executables have no PSP
  5008.     under the FlashTek X-32 DOS extender, only function 00h is supported
  5009.       and the pointers are passed in DS:EDX and ES:EBX
  5010.     DR DOS 6 always loads .EXE-format programs with no fixups and
  5011.       .COM-format programs starting with 9Ch 55h (PUSHF/PUSH BP) above the
  5012.       64K mark to avoid the EXEPACK bug, by extending the memory block
  5013.       containing the program's environment; this code is disabled if the
  5014.       name of the parent program as stored in the MCB is 'WIN'.
  5015. BUGS:    DOS 2.00 assumes that DS points at the current program's PSP
  5016.     Load Overlay (subfunction 03h) loads up to 512 bytes too many if the
  5017.       file contains additional data after the actual overlay
  5018. SeeAlso: AX=4B05h,AH=4Ch,AH=4Dh,AH=64h"OS/2",AH=8Ah,INT 2E,INT 60/DI=0604h
  5019.  
  5020. Format of EXEC parameter block for AL=00h,01h,04h:
  5021. Offset    Size    Description    (Table 0897)
  5022.  00h    WORD    segment of environment to copy for child process (copy caller's
  5023.           environment if 0000h)
  5024.  02h    DWORD    pointer to command tail to be copied into child's PSP
  5025.  06h    DWORD    pointer to first FCB to be copied into child's PSP
  5026.  0Ah    DWORD    pointer to second FCB to be copied into child's PSP
  5027.  0Eh    DWORD    (AL=01h) will hold subprogram's initial SS:SP on return
  5028.  12h    DWORD    (AL=01h) will hold entry point (CS:IP) on return
  5029. SeeAlso: #0898,#0899
  5030.  
  5031. Format of EXEC parameter block for AL=03h:
  5032. Offset    Size    Description    (Table 0898)
  5033.  00h    WORD    segment at which to load overlay
  5034.  02h    WORD    relocation factor to apply to overlay if in .EXE format
  5035. SeeAlso: #0897,#0899
  5036.  
  5037. Format of EXEC parameter block for FlashTek X-32:
  5038. Offset    Size    Description    (Table 0899)
  5039.  00h    PWORD    48-bit far pointer to environment string
  5040.  06h    PWORD    48-bit far pointer to command tail string
  5041. SeeAlso: #0897,#0898
  5042.  
  5043. (Table 0900)
  5044. Values for the executable types understood by various environments:
  5045.  MZ    old-style DOS executable (see #0901)
  5046.  NE    Windows or OS/2 1.x segmented ("new") executable (see #0903)
  5047.  LE    Windows virtual device driver (VxD) linear executable (see #0916)
  5048.  LX    variant of LE used in OS/2 2.x (see #0916)
  5049.  W3    Windows WIN386.EXE file; a collection of LE files
  5050.  PE    Win32 (Windows NT and Win32s) portable executable based on Unix COFF
  5051.  DL    HP 100LX/200LX system manager compliant executable (.EXM)
  5052.  MP    old PharLap .EXP (see #0926)
  5053.  P2    PharLap 286 .EXP (see #0927)
  5054.  P3    PharLap 386 .EXP (see #0927)
  5055.  
  5056. Format of .EXE file header:
  5057. Offset    Size    Description    (Table 0901)
  5058.  00h  2 BYTEs    .EXE signature, either "MZ" or "ZM" (5A4Dh or 4D5Ah)
  5059.           (see also #0900)
  5060.  02h    WORD    number of bytes in last 512-byte page of executable
  5061.  04h    WORD    total number of 512-byte pages in executable (includes any
  5062.         partial last page)
  5063.  06h    WORD    number of relocation entries
  5064.  08h    WORD    header size in paragraphs
  5065.  0Ah    WORD    minimum paragraphs of memory required to allocate in addition
  5066.           to executable's size
  5067.  0Ch    WORD    maximum paragraphs to allocate in addition to executable's size
  5068.  0Eh    WORD    initial SS relative to start of executable
  5069.  10h    WORD    initial SP
  5070.  12h    WORD    checksum (one's complement of sum of all words in executable)
  5071.  14h    DWORD    initial CS:IP relative to start of executable
  5072.  18h    WORD    offset within header of relocation table
  5073.         40h or greater for new-format (NE,LE,LX,W3,PE,etc.) executable
  5074.  1Ah    WORD    overlay number (normally 0000h = main program)
  5075. ---new executable---
  5076.  1Ch  4 BYTEs    ???
  5077.  20h    WORD    behavior bits
  5078.  22h 26 BYTEs    reserved for additional behavior info
  5079.  3Ch    DWORD    offset of new executable (NE,LE,etc) header within disk file,
  5080.         or 00000000h if plain MZ executable
  5081. ---Borland TLINK---
  5082.  1Ch  2 BYTEs    ??? (apparently always 01h 00h)
  5083.  1Eh    BYTE    signature FBh
  5084.  1Fh    BYTE    TLINK version (major in high nybble, minor in low nybble)
  5085.  20h  2 BYTEs    ??? (v2.0 apparently always 72h 6Ah, v3.0+ seems always 6Ah 72h)
  5086. ---ARJ self-extracting archive---
  5087.  1Ch  4 BYTEs    signature "RJSX" (older versions, new signature is "aRJsfX" in
  5088.         the first 1000 bytes of the file)
  5089. ---LZEXE 0.90 compressed executable---
  5090.  1Ch  4 BYTEs    signature "LZ09"
  5091. ---LZEXE 0.91 compressed executable---
  5092.  1Ch  4 BYTEs    signature "LZ91"
  5093. ---PKLITE compressed executable---
  5094.  1Ch    BYTE    minor version number
  5095.  1Dh    BYTE    bits 0-3: major version
  5096.         bit 4: extra compression
  5097.         bit 5: huge (multi-segment) file
  5098.  1Eh  6 BYTEs    signature "PKLITE" (followed by copyright message)
  5099. ---LHarc 1.x self-extracting archive---
  5100.  1Ch  4 BYTEs    unused???
  5101.  20h  3 BYTEs    jump to start of extraction code
  5102.  23h  2 BYTEs    ???
  5103.  25h 12 BYTEs    signature "LHarc's SFX "
  5104. ---LHA 2.x self-extracting archive---
  5105.  1Ch  8 BYTEs    ???
  5106.  24h 10 BYTEs    signature "LHa's SFX " (v2.10) or "LHA's SFX " (v2.13)
  5107. ---TopSpeed C 3.0 CRUNCH compressed file---
  5108.  1Ch    DWORD    018A0001h
  5109.  20h    WORD    1565h
  5110. ---PKARCK 3.5 self-extracting archive---
  5111.  1Ch    DWORD    00020001h
  5112.  20h    WORD    0700h
  5113. ---BSA (Soviet archiver) self-extracting archive---
  5114.  1Ch    WORD    000Fh
  5115.  1Eh    BYTE    A7h
  5116. ---LARC self-extracting archive---
  5117.  1Ch  4 BYTEs    ???
  5118.  20h 11 BYTEs    "SFX by LARC "
  5119. ---LH self-extracting archive---
  5120.  1Ch  8 BYTEs    ???
  5121.  24h  8 BYTEs    "LH's SFX "
  5122. ---other linkers---
  5123.  1Ch    var    optional information
  5124. ---
  5125.   N   N DWORDs    relocation items
  5126. Notes:    if word at offset 02h is 4, it should be treated as 00h, since pre-1.10
  5127.       versions of the MS linker set it that way
  5128.     if both minimum and maximum allocation (offset 0Ah/0Ch) are zero, the
  5129.       program is loaded as high in memory as possible (DOS only checks
  5130.       the maximum allocation, however)
  5131.     the maximum allocation is set to FFFFh by default
  5132.     additional data may be contained in the file beyond the end of the
  5133.       load image described by the .EXE header; this data may be overlays,
  5134.       the actual executable for newer-format executables, or debugging
  5135.       information (see #0907,#0931)
  5136. SeeAlso: #0903
  5137.  
  5138. Format of ROM Module Header:
  5139. Offset    Size    Description    (Table 0902)
  5140.  00h  2 BYTEs    ROM signature 55h, AAh
  5141.  02h    BYTE    size of ROM in 512-byte blocks
  5142.  03h  3 BYTEs    POST initialization entry point (near JMP instruction)
  5143.  06h    ROM Program Name List [array]
  5144.     Offset    Size    Description
  5145.      00h    BYTE    length of ROM program's name (00h if end of name list)
  5146.      01h  N BYTEs    program name
  5147.      N+1  3 BYTEs    program entry point (near JMP instruction)
  5148.  
  5149. Format of new executable header:
  5150. Offset    Size    Description    (Table 0903)
  5151.  00h  2 BYTEs    "NE" (4Eh 45h) signature
  5152.  02h  2 BYTEs    linker version (major, then minor)
  5153.  04h    WORD    offset from start of this header to entry table (see #0910)
  5154.  06h    WORD    length of entry table in bytes
  5155.  08h    DWORD    file load CRC (0 in Borland's TPW)
  5156.  0Ch    BYTE    program flags (see #0904)
  5157.  0Dh    BYTE    application flags (see #0905)
  5158.  0Eh    WORD    auto data segment index
  5159.  10h    WORD    initial local heap size
  5160.  12h    WORD    initial stack size (added to data seg, 0000h if SS <> DS)
  5161.  14h    DWORD    program entry point (CS:IP), "CS" is index into segment table
  5162.  18h    DWORD    initial stack pointer (SS:SP), "SS" is segment index
  5163.         if SS=automatic data segment and SP=0000h, the stack pointer is
  5164.           set to the top of the automatic data segment, just below the
  5165.           local heap
  5166.  1Ch    WORD    segment count
  5167.  1Eh    WORD    module reference count
  5168.  20h    WORD    length of nonresident names table in bytes
  5169.  22h    WORD    offset from start of this header to segment table (see #0908)
  5170.  24h    WORD    offset from start of this header to resource table
  5171.  26h    WORD    offset from start of this header to resident names table
  5172.  28h    WORD    offset from start of this header to module reference table
  5173.  2Ah    WORD    offset from start of this header to imported names table
  5174.         (array of counted strings, terminated with a string of length
  5175.           00h)
  5176.  2Ch    DWORD    offset from start of file to nonresident names table
  5177.  30h    WORD    count of moveable entry point listed in entry table
  5178.  32h    WORD    file alignment size shift count
  5179.         0 is equivalent to 9 (default 512-byte pages)
  5180.  34h    WORD    number of resource table entries
  5181.  36h    BYTE    target operating system
  5182.         00h unknown
  5183.         01h OS/2
  5184.         02h Windows
  5185.         03h European MS-DOS 4.x
  5186.         04h Windows 386
  5187.         05h BOSS (Borland Operating System Services)
  5188.         81h PharLap 286|DOS-Extender, OS/2
  5189.         82h PharLap 286|DOS-Extender, Windows
  5190.  37h    BYTE    other EXE flags (see #0906)
  5191.  38h    WORD    offset to return thunks or start of gangload area
  5192.  3Ah    WORD    offset to segment reference thunks or length of gangload area
  5193.  3Ch    WORD    minimum code swap area size
  5194.  3Eh  2 BYTEs    expected Windows version (minor version first)
  5195. Note:    this header is documented in detail in the Windows 3.1 SDK Programmer's
  5196.       Reference, Vol 4.
  5197. SeeAlso: #0901
  5198.  
  5199. Bitfields for new executable program flags:
  5200. Bit(s)    Description    (Table 0904)
  5201.  0-1    DGROUP type
  5202.       0 = none
  5203.       1 = single shared
  5204.       2 = multiple (unshared)
  5205.       3 = (null)
  5206.  2    global initialization
  5207.  3    protected mode only
  5208.  4    8086 instructions
  5209.  5    80286 instructions
  5210.  6    80386 instructions
  5211.  7    80x87 instructions
  5212.  
  5213. Bitfields for new executable application flags:
  5214. Bit(s)    Description    (Table 0905)
  5215.  0-2    application type
  5216.     001 full screen (not aware of Windows/P.M. API)
  5217.     010 compatible with Windows/P.M. API
  5218.     011 uses Windows/P.M. API
  5219.  3    is a Family Application (OS/2)
  5220.  5    0=executable, 1=errors in image
  5221.  6    non-conforming program (valid stack is not maintained)
  5222.  7    DLL or driver rather than application
  5223.     (SS:SP info invalid, CS:IP points at FAR init routine called with
  5224.       AX=module handle which returns AX=0000h on failure, AX nonzero on
  5225.       successful initialization)
  5226.  
  5227. Bitfields for other new .EXE flags:
  5228. Bit(s)    Description    (Table 0906)
  5229.  0    supports long filenames
  5230.  1    2.X protected mode
  5231.  2    2.X proportional font
  5232.  3    gangload area
  5233.  
  5234. Format of Codeview trailer (at end of executable):
  5235. Offset    Size    Description    (Table 0907)
  5236.  00h    WORD    signature 4E42h ('NB')
  5237.  02h    WORD    Microsoft debug info version number
  5238.  04h    DWORD    Codeview header offset
  5239. SeeAlso: #0931
  5240.  
  5241. Format of new executable segment table record:
  5242. Offset    Size    Description    (Table 0908)
  5243.  00h    WORD    offset in file (shift left by alignment shift to get byte offs)
  5244.  02h    WORD    length of image in file (0000h = 64K)
  5245.  04h    WORD    segment attributes (see #0909)
  5246.  06h    WORD    number of bytes to allocate for segment (0000h = 64K)
  5247. Note:    the first segment table entry is entry number 1
  5248. SeeAlso: #0911
  5249.  
  5250. Bitfields for segment attributes:
  5251. Bit(s)    Description    (Table 0909)
  5252.  0    data segment rather than code segment
  5253.  1    unused???
  5254.  2    real mode
  5255.  3    iterated
  5256.  4    movable
  5257.  5    sharable
  5258.  6    preloaded rather than demand-loaded
  5259.  7    execute-only (code) or read-only (data)
  5260.  8    relocations (directly following code for this segment)
  5261.  9    debug info present
  5262.  10,11    80286 DPL bits
  5263.  12    discardable
  5264.  13-15    discard priority
  5265.  
  5266. Format of new executable entry table item (list):
  5267. Offset    Size    Description    (Table 0910)
  5268.  00h    BYTE    number of entry points (00h if end of entry table list)
  5269.  01h    BYTE    segment number (00h if end of entry table list)
  5270.  02h 3N BYTEs    entry records
  5271.         Offset    Size    Description
  5272.          00h    BYTE    flags
  5273.                 bit 0: exported
  5274.                 bit 1: single data
  5275.                 bits 2-7: unused???
  5276.          01h    WORD    offset within segment
  5277.  
  5278. Format of new executable relocation data (immediately follows segment image):
  5279. Offset    Size    Description    (Table 0911)
  5280.  00h    WORD    number of relocation items
  5281.  02h 8N BYTEs    relocation items
  5282.         Offset    Size    Description
  5283.          00h    BYTE    relocation type
  5284.                 00h LOBYTE
  5285.                 02h BASE
  5286.                 03h PTR
  5287.                 05h OFFS
  5288.                 0Bh PTR48
  5289.                 0Dh OFFS32
  5290.          01h    BYTE    flags
  5291.                 bit 2: additive
  5292.          02h    WORD    offset within segment
  5293.          04h    WORD    target address segment
  5294.          06h    WORD    target address offset
  5295. SeeAlso: #0908,#0912
  5296.  
  5297. Format of new executable resource data:
  5298. Offset    Size    Description    (Table 0912)
  5299.  00h    WORD    alignment shift count for resource data
  5300.  02h  N RECORDs resources
  5301.     Format of resource record:
  5302.     Offset    Size    Description
  5303.      00h    WORD    type ID
  5304.             0000h if end of resource records
  5305.             >= 8000h if integer type
  5306.             else offset from start of resource table to type string
  5307.      02h    WORD    number of resources of this type
  5308.      04h    DWORD    reserved for runtime use
  5309.      08h  N Resources (see #0913)
  5310. Note:    resource type and name strings are stored immediately following the
  5311.       resource table, and are not null-terminated
  5312. SeeAlso: #0913
  5313.  
  5314. Format of new executable resource entry:
  5315. Offset    Size    Description    (Table 0913)
  5316.  00h    WORD    offset in alignment units from start of file to contents of
  5317.         the resource data
  5318.  02h    WORD    length of resource image in bytes
  5319.  04h    WORD    flags
  5320.         bit 4: moveable
  5321.         bit 5: shareable
  5322.         bit 6: preloaded
  5323.  06h    WORD    resource ID
  5324.         >= 8000h if integer resource
  5325.         else offset from start of resource table to resource string
  5326.  08h    DWORD    reserved for runtime use
  5327. Notes:    resource type and name strings are stored immediately following the
  5328.       resource table, and are not null-terminated
  5329.     strings are counted strings, with a string of length 0 indicating the
  5330.       end of the resource table
  5331. SeeAlso: #0912,#0914
  5332.  
  5333. Format of new executable module reference table [one bundle of entries]:
  5334. Offset    Size    Description    (Table 0914)
  5335.  00h    BYTE    number of records in this bundle (00h if end of table)
  5336.  01h    BYTE    segment indicator
  5337.         00h unused
  5338.         FFh movable segment, segment number is in entry
  5339.         else segment number of fixed segment
  5340.  02h  N RECORDs
  5341.     Format of segment record
  5342.     Offset    Size    Description
  5343.      00h    BYTE    flags
  5344.             bit 0: entry is exported
  5345.             bit 1: entry uses global (shared) data
  5346.             bits 7-3: number of parameter words
  5347.     ---fixed segment---
  5348.      01h    WORD    offset
  5349.     ---moveable segment---
  5350.      01h  2 BYTEs    INT 3F instruction (CDh 3Fh)
  5351.      03h    BYTE    segment number
  5352.      05h    WORD    offset
  5353. Note:    table entries are numbered starting from 1
  5354. SeeAlso: #0915
  5355.  
  5356. Format of new executable resident/nonresident name table entry:
  5357. Offset    Size    Description    (Table 0915)
  5358.  00h    BYTE    length of string (00h if end of table)
  5359.  01h  N BYTEs    ASCII text of string
  5360.  N+1    WORD    ordinal number (index into entry table)
  5361. Notes:    the first string in the resident name table is the module name; the
  5362.       first entry in the nonresident name table is the module description
  5363.     the strings are case-sensitive; if the executable was linked with
  5364.       /IGNORECASE, all strings are in uppercase
  5365. SeeAlso: #0914
  5366.  
  5367. Format of Linear Executable (enhanced mode executable) header:
  5368. Offset    Size    Description    (Table 0916)
  5369.  00h  2 BYTEs    "LE" (4Ch 45h) signature (Windows)
  5370.         "LX" (4Ch 58h) signature (OS/2)
  5371.  02h    BYTE    byte order (00h = little-endian, nonzero = big-endian)
  5372.  03h    BYTE    word order (00h = little-endian, nonzero = big-endian)
  5373.  04h    DWORD    executable format level
  5374.  08h    WORD    CPU type (see also INT 15/AH=C9h)
  5375.         01h Intel 80286 or upwardly compatible
  5376.         02h Intel 80386 or upwardly compatible
  5377.         03h Intel 80486 or upwardly compatible
  5378.         04h Intel Pentium (80586) or upwardly compatible
  5379.         20h Intel i860 (N10) or compatible
  5380.         21h Intel "N11" or compatible
  5381.         40h MIPS Mark I (R2000, R3000) or compatible
  5382.         41h MIPS Mark II (R6000) or compatible
  5383.         42h MIPS Mark III (R4000) or compatible
  5384.  0Ah    WORD    target operating system
  5385.         01h OS/2
  5386.         02h Windows
  5387.         03h European DOS 4.0
  5388.         04h Windows 386
  5389.  0Ch    DWORD    module version
  5390.  10h    DWORD    module type (see #0917)
  5391.  14h    DWORD    number of memory pages
  5392.  18h    Initial CS:EIP
  5393.     DWORD    object number
  5394.     DWORD    offset
  5395.  20h    Initial SS:ESP
  5396.     DWORD    object number
  5397.     DWORD    offset
  5398.  28h    DWORD    memory page size
  5399.  2Ch    DWORD    (Windows LE) bytes on last page
  5400.         (OS/2 LX) page offset shift count
  5401.  30h    DWORD    fixup section size
  5402.  34h    DWORD    fixup section checksum
  5403.  38h    DWORD    loader section size
  5404.  3Ch    DWORD    loader section checksum
  5405.  40h    DWORD    offset of object table (see #0918)
  5406.  44h    DWORD    object table entries
  5407.  48h    DWORD    object page map table offset (see #0920)
  5408.  4Ch    DWORD    object iterate data map offset
  5409.  50h    DWORD    resource table offset
  5410.  54h    DWORD    resource table entries
  5411.  58h    DWORD    resident names table offset (see #0921)
  5412.  5Ch    DWORD    entry table offset (see #0922,#0923)
  5413.  60h    DWORD    module directives table offset
  5414.  64h    DWORD    Module Directives entries
  5415.  68h    DWORD    Fixup page table offset
  5416.  6Ch    DWORD    Fixup record table offset (see #0925)
  5417.  70h    DWORD    imported modules name table offset
  5418.  74h    DWORD    imported modules count
  5419.  78h    DWORD    imported procedures name table offset
  5420.  7Ch    DWORD    per-page checksum table offset
  5421.  80h    DWORD    data pages offset
  5422.  84h    DWORD    preload page count
  5423.  88h    DWORD    non-resident names table offset
  5424.  8Ch    DWORD    non-resident names table length
  5425.  90h    DWORD    non-resident names checksum
  5426.  94h    DWORD    automatic data object
  5427.  98h    DWORD    debug information offset
  5428.  9Ch    DWORD    debug information length
  5429.  A0h    DWORD    preload instance pages number
  5430.  A4h    DWORD    demand instance pages number
  5431.  A8h    DWORD    extra heap allocation
  5432.  ACh 12 BYTEs    reserved
  5433.  B8h    DWORD    offset of VERSIONINFO resource (MS-Windows VxD only)
  5434.  BCh    DWORD    pointer to ??? (dynamically-loadable VxDs only???)
  5435.  C0h    WORD    device ID (MS-Windows VxD only)
  5436.  C2h    WORD    DDK version (MS-Windows VxD only)
  5437. Note:    used by EMM386.EXE, QEMM, and Windows 3.0 Enhanced Mode drivers
  5438.  
  5439. Bitfields for Linear Executable module type:
  5440. Bit(s)    Description    (Table 0917)
  5441.  2    initialization (only for DLLs) 0 = global, 1 = per-process
  5442.  4    no internal fixups in executable image
  5443.  5    no external fixups in executable image
  5444.  8-10    API compatibility
  5445.     0 = unknown
  5446.     1 = incompatible with PM windowing \
  5447.     2 = compatible with PM windowing    > (only for
  5448.     3 = uses PM windowing API       /    programs)
  5449.  13    module not loadable (only for programs)
  5450.  15-17    module type
  5451.     000 program
  5452.     001 library (DLL)
  5453.     011 protected memory library module
  5454.     100 physical device driver
  5455.     110 virtual device driver
  5456.  30    per-process library termination
  5457.     (requires valid CS:EIP, can't be set for .EXE)
  5458.  
  5459. Format of object table entry:
  5460. Offset    Size    Description    (Table 0918)
  5461.  00h    DWORD    virtual size in bytes
  5462.  04h    DWORD    relocation base address
  5463.  08h    DWORD    object flags (see #0919)
  5464.  0Ch    DWORD    page map index
  5465.  10h    DWORD    page map entries (see #0920)
  5466.  14h  4 BYTEs    reserved??? (apparently always zeros)
  5467.  
  5468. Bitfields for object flags:
  5469. Bit(s)    Description    (Table 0919)
  5470.  0    readable
  5471.  1    writable
  5472.  2    executable
  5473.  3    resource
  5474.  4    discardable
  5475.  5    shared
  5476.  6    preloaded
  5477.  7    invalid
  5478.  8-9    type
  5479.     00 normal
  5480.     01 zero-filled
  5481.     10 resident
  5482.     11 resident and contiguous
  5483.  10    resident and long-lockable
  5484.  11    reserved
  5485.  12    16:16 alias required
  5486.  13    "BIG" (Huge: 32-bit)
  5487.  14    conforming
  5488.  15    "OBJECT_I/O_PRIVILEGE_LEVEL"
  5489.  16-31    reserved
  5490.  
  5491. Format of object page map table entry:
  5492. Offset    Size    Description    (Table 0920)
  5493.  00h    BYTE    ??? (usually 00h)
  5494.  01h    WORD    (big-endian) index to fixup table
  5495.         0000h if no relocation info
  5496.  03h    BYTE    type (00h hard copy in file, 03h some relocation needed)
  5497.  
  5498. Format of resident names table entry:
  5499. Offset    Size    Description    (Table 0921)
  5500.  00h    BYTE    length of name
  5501.  01h  N BYTEs    name
  5502.  N+1  3 BYTEs    ???
  5503.  
  5504. Format of LE linear executable entry table:
  5505. Offset    Size    Description    (Table 0922)
  5506.  00h    BYTE    number of entries in table
  5507.  01h 10 BYTEs per entry
  5508.         Offset    Size    Description
  5509.          00h    BYTE    bit flags
  5510.                 bit 0: non-empty bundle
  5511.                 bit 1: 32-bit entry
  5512.          01h    WORD    object number
  5513.          03h    BYTE    entry type flags
  5514.                 bit 0: exported
  5515.                 bit 1: uses single data rather than instance
  5516.                 bit 2: reserved
  5517.                 bits 3-7: number of stack parameters
  5518.          04h    DWORD    offset of entry point
  5519.          08h  2 BYTEs    ???
  5520. Note:    empty bundles (bit flags at 00h = 00h) are used to skip unused indices,
  5521.       and do not contain the remaining nine bytes
  5522.  
  5523. Format of LX linear executable entry table [array]:
  5524. Offset    Size    Description    (Table 0923)
  5525.  00h    BYTE    number of bundles following (00h = end of entry table)
  5526.  01h    BYTE    bundle type
  5527.         00h empty
  5528.         01h 16-bit entry
  5529.         02h 286 callgate entry
  5530.         03h 32-bit entry
  5531.         04h forwarder entry
  5532.         bit 7 set if additional parameter typing information is present
  5533. ---bundle type 00h---
  5534.  no additional fields
  5535. ---bundle type 01h---
  5536.  02h    WORD    object number
  5537.  04h    BYTE    entry flags
  5538.         bit 0: exported
  5539.         bits 7-3: number of stack parameters
  5540.  05h    WORD    offset of entry point in object (shifted by page size shift)
  5541. ---bundle type 02h---
  5542.  02h    WORD    object number
  5543.  04h    BYTE    entry flags
  5544.         bit 0: exported
  5545.         bits 7-3: number of stack parameters
  5546.  05h    WORD    offset of entry point in object
  5547.  07h    WORD    reserved for callgate selector (used by loader)
  5548. ---bundle type 03h---
  5549.  02h    WORD    object number
  5550.  04h    BYTE    entry flags
  5551.         bit 0: exported
  5552.         bits 7-3: number of stack parameters
  5553.  05h    DWORD    offset of entry point in object
  5554. ---bundle type 04h---
  5555.  02h    WORD    reserved
  5556.  04h    BYTE    forwarder flags
  5557.         bit 0: import by ordinal
  5558.         bits 7-1 reserved
  5559.  05h    WORD    module ordinal
  5560.         (forwarder's index into Import Module Name table)
  5561.  07h    DWORD    procedure name offset or import ordinal number
  5562. Note:    all fields after the first two bytes are repeated N times
  5563.  
  5564. Bitfields for linear executable fixup type:
  5565. Bit(s)    Description    (Table 0924)
  5566.  7    ordinal is BYTE rather than WORD
  5567.  6    16-rather than 8-object number/module ordinal
  5568.  5    addition with DWORD rather than WORD
  5569.  4    relocation info has size with new two bytes at end
  5570.  3    reserved (0)
  5571.  2    set if add to destination, clear to replace destination
  5572.  1-0    type
  5573.     00 internal fixup
  5574.     01 external fixup, imported by ordinal
  5575.     10 external fixup, imported by name
  5576.     11 internal fixup via entry table
  5577.  
  5578. Format of linear executable fixup record:
  5579. Offset    Size    Description    (Table 0925)
  5580.  00h    BYTE    type
  5581.         bits 7-4: modifier (0001 single, 0011 multiple)
  5582.         bits 3-0: type
  5583.             0000 byte offset
  5584.             0010 word segment
  5585.             0011 16-bit far pointer (DWORD)
  5586.             0101 16-bit offset
  5587.             0110 32-bit far pointer (PWORD)
  5588.             0111 32-bit offset
  5589.             1000 near call or jump, WORD/DWORD based on seg attrib
  5590.  01h    BYTE    linear executable fixup type (see #0924)
  5591. ---if single type---
  5592.  02h    WORD    offset within page
  5593.  04h    relocation information
  5594.     ---internal fixup---
  5595.     BYTE    object number
  5596.     ---external,ordinal---
  5597.     BYTE    one-based module number in Import Module table
  5598.     BYTE/WORD ordinal number
  5599.     WORD/DWORD value to add (only present if modifier bit 4 set)
  5600.     ---external,name---
  5601.     BYTE    one-based module number in Import Module table
  5602.     WORD    offset in Import Procedure names
  5603.     WORD/DWORD value to add (only present if modifier bit 4 set)
  5604. ---if multiple type---
  5605.  02h    BYTE    number of items
  5606.  03h    var    relocation info as for "single" type (see above)
  5607.       N WORDs    offsets of items to relocate
  5608.  
  5609. Format of old Phar Lap .EXP file header:
  5610. Offset    Size    Description    (Table 0926)
  5611.  00h  2 BYTEs    "MP" (4Dh 50h) signature
  5612.  02h    WORD    remainder of image size / page size (page size = 512h)
  5613.  04h    WORD    size of image in pages
  5614.  06h    WORD    number of relocation items
  5615.  08h    WORD    header size in paragraphs
  5616.  0Ah    WORD    minimum number of extra 4K pages to be allocated at the end
  5617.           of program, when it is loaded
  5618.  0Ch    WORD    maximum number of extra 4K pages to be allocated at the end
  5619.           of program, when it is loaded
  5620.  0Eh    DWORD    initial ESP
  5621.  12h    WORD    word checksum of file
  5622.  14h    DWORD    initial EIP
  5623.  18h    WORD    offset of first relocation item
  5624.  1Ah    WORD    overlay number
  5625.  1Ch    WORD    ??? (wants to be 1)
  5626. SeeAlso: #0927
  5627.  
  5628. Format of new Phar Lap .EXP file header:
  5629. Offset    Size    Description    (Table 0927)
  5630.  00h  2 BYTEs    signature ("P2" for 286 .EXP executable, "P3" for 386 .EXP)
  5631.  02h    WORD    level (01h flat-model file, 02h multisegmented file)
  5632.  04h    WORD    header size
  5633.  06h    DWORD    file size in bytes
  5634.  0Ah    WORD    checksum
  5635.  0Ch    DWORD    offset of run-time parameters within file (see #0929)
  5636.  10h    DWORD    size of run-time parameters in bytes
  5637.  14h    DWORD    offset of relocation table within file
  5638.  18h    DWORD    size of relocation table in bytes
  5639.  1Ch    DWORD    offset of segment information table within file (see #0928)
  5640.  20h    DWORD    size of segment information table in bytes
  5641.  24h    WORD    size of segment information table entry in bytes
  5642.  26h    DWORD    offset of load image within file
  5643.  2Ah    DWORD    size of load image on disk
  5644.  2Eh    DWORD    offset of symbol table within file or 00000000h
  5645.  32h    DWORD    size of symbol table in bytes
  5646.  36h    DWORD    offset of GDT within load image
  5647.  3Ah    DWORD    size of GDT in bytes
  5648.  3Eh    DWORD    offset of LDT within load image
  5649.  42h    DWORD    size of LDT in bytes
  5650.  46h    DWORD    offset of IDT within load image
  5651.  4Ah    DWORD    size of IDT in bytes
  5652.  4Eh    DWORD    offset of TSS within load image
  5653.  52h    DWORD    size of TSS in bytes
  5654.  56h    DWORD    minimum number of extra bytes to be allocated at end of program
  5655.         (level 1 executables only)
  5656.  5Ah    DWORD    maximum number of extra bytes to be allocated at end of program
  5657.         (level 1 executables only)
  5658.  5Eh    DWORD    base load offset (level 1 executables only)
  5659.  62h    DWORD    initial ESP
  5660.  66h    WORD    initial SS
  5661.  68h    DWORD    initial EIP
  5662.  6Ch    WORD    initial CS
  5663.  6Eh    WORD    initial LDT
  5664.  70h    WORD    initial TSS
  5665.  72h    WORD    flags
  5666.         bit 0: load image is packed
  5667.         bit 1: 32-bit checksum is present
  5668.         bits 4-2: type of relocation table
  5669.  74h    DWORD    memory requirements for load image
  5670.  78h    DWORD    32-bit checksum (optional)
  5671.  7Ch    DWORD    size of stack segment in bytes
  5672.  80h 256 BYTEs    reserved (0)
  5673. SeeAlso: #0926,#0930
  5674.  
  5675. Format of Phar Lap segment information table entry:
  5676. Offset    Size    Description    (Table 0928)
  5677.  00h    WORD    selector number
  5678.  02h    WORD    flags
  5679.  04h    DWORD    base offset of selector
  5680.  08h    DWORD    minimum number of extra bytes to be allocated to the segment
  5681.  
  5682. Format of 386|DOS-Extender run-time parameters:
  5683. Offset    Size    Description    (Table 0929)
  5684.  00h  2 BYTEs    signature "DX" (44h 58h)
  5685.  02h    WORD    minimum number of real-mode params to leave free at run time
  5686.  04h    WORD    maximum number of real-mode params to leave free at run time
  5687.  06h    WORD    minimum interrupt buffer size in KB
  5688.  08h    WORD    maximum interrupt buffer size in KB
  5689.  0Ah    WORD    number of interrupt stacks
  5690.  0Ch    WORD    size in KB of each interrupt stack
  5691.  0Eh    DWORD    offset of byte past end of real-mode code and data
  5692.  12h    WORD    size in KB of call buffers
  5693.  14h    WORD    flags
  5694.         bit 0: file is virtual memory manager
  5695.         bit 1: file is a debugger
  5696.  16h    WORD    unprivileged flag (if nonzero, executes at ring 1, 2, or 3)
  5697.  18h 104 BYTEs    reserved (0)
  5698.  
  5699. Format of Phar Lap repeat block header:
  5700. Offset    Size    Description    (Table 0930)
  5701.  00h    WORD    byte count
  5702.  02h    BYTE    repeat string length
  5703.  
  5704. Format of Borland debugging information header (following load image):
  5705. Offset    Size    Description    (Table 0931)
  5706.  00h    WORD    signature 52FBh
  5707.  02h    WORD    version ID
  5708.  04h    DWORD    size of name pool in bytes
  5709.  08h    WORD    number of names in name pool
  5710.  0Ah    WORD    number of type entries
  5711.  0Ch    WORD    number of structure members
  5712.  0Eh    WORD    number of symbols
  5713.  10h    WORD    number of global symbols
  5714.  12h    WORD    number of modules
  5715.  14h    WORD    number of locals (optional)
  5716.  16h    WORD    number of scopes in table
  5717.  18h    WORD    number of line-number entries
  5718.  1Ah    WORD    number of include files
  5719.  1Ch    WORD    number of segment records
  5720.  1Eh    WORD    number of segment/file correlations
  5721.  20h    DWORD    size of load image after removing uninitialized data and debug
  5722.           information
  5723.  24h    DWORD    debugger hook; pointer into debugged program whose meaning
  5724.           depends on program flags
  5725.  28h    BYTE    program flags
  5726.         bit 0: case-sensitive link
  5727.         bit 1: pascal overlay program
  5728.  29h    WORD    no longer used
  5729.  2Bh    WORD    size of data pool in bytes
  5730.  2Dh    BYTE    padding
  5731.  2Eh    WORD    size of following header extension (currently 00h, 10h, or 20h)
  5732.  30h    WORD    number of classes
  5733.  32h    WORD    number of parents
  5734.  34h    WORD    number of global classes (currently unused)
  5735.  36h    WORD    number of overloads (currently unused)
  5736.  38h    WORD    number of scope classes
  5737.  3Ah    WORD    number of module classes
  5738.  3Ch    WORD    number of coverage offsets
  5739.  3Eh    DWORD    offset relative to symbol base of name pool
  5740.  42h    WORD    number of browser information records
  5741.  44h    WORD    number of optimized symbol records
  5742.  46h    WORD    debugging flags
  5743.  48h  8 BYTEs    padding
  5744. Note:    additional information on the Borland debugging info may be found in
  5745.       Borland's Open Architecture Handbook
  5746. SeeAlso: #0907
  5747. --------U-214B-------------------------------
  5748. INT 21 - ELRES v1.0 only - INSTALLATION CHECK
  5749.     AH = 4Bh
  5750.     DS:DX = 0000h:0000h
  5751. Return: ES:BX -> ELRES history structure (see #0694 at AH=2Bh/CX=454Ch)
  5752.     DX = DABEh (signature, DAve BEnnett)
  5753. Program: ELRES is an MS-DOS return code (errorlevel) recorder by David H.
  5754.       Bennett
  5755. SeeAlso: AH=2Bh/CX=454Ch
  5756. --------v-214B04-----------------------------
  5757. INT 21 - VIRUS - "MG", "699"/"Thirteen Minutes" - INSTALLATION CHECK
  5758.     AX = 4B04h
  5759. Return: CF clear if "MG" resident
  5760.     AX = 044Bh if "699"/"Thirteen Minutes" resident
  5761. SeeAlso: AX=4243h,AH=4Ah/BX=FFFFh,AX=4B21h
  5762. --------D-214B05-----------------------------
  5763. INT 21 - DOS 5+ - SET EXECUTION STATE
  5764.     AX = 4B05h
  5765.     DS:DX -> execution state structure (see #0932)
  5766. Return: CF clear if successful
  5767.         AX = 0000h
  5768.     CF set on error
  5769.         AX = error code (see #0980 at AH=59h)
  5770. Note:    used by programs which intercept AX=4B00h to prepare new programs for
  5771.       execution (including setting the DOS version number).     No DOS, BIOS
  5772.       or other software interrupt may be called after return from this call
  5773.       before commencement of the child process.  If DOS is running in the
  5774.       HMA, A20 is turned off on return from this call.
  5775. SeeAlso: AH=4Bh
  5776.  
  5777. Format of execution state structure:
  5778. Offset    Size    Description    (Table 0932)
  5779.  00h    WORD    reserved (00h)
  5780.  02h    WORD    type flags
  5781.         bit 0: program is an .EXE
  5782.         bit 1: program is an overlay
  5783.  04h    DWORD    pointer to ASCIZ name of program file
  5784.  08h    WORD    PSP segment of new program
  5785.  0Ah    DWORD    starting CS:IP of new program
  5786.  0Eh    DWORD    program size including PSP
  5787. --------v-214B20-----------------------------
  5788. INT 21 - VIRUS - "Holocaust"/"Telefonica" - ???
  5789.     AX = 4B20h
  5790. SeeAlso: AX=4B04h,AX=4B21h
  5791. --------v-214B21-----------------------------
  5792. INT 21 C - VIRUS - "Holocaust"/"Telefonica" - ???
  5793.     AX = 4B21h
  5794. Note:    called at completion of virus installation
  5795. SeeAlso: AX=4B04h,AX=4B20h,AX=4B25h
  5796. --------v-214B25-----------------------------
  5797. INT 21 - VIRUS - "1063"/"Mono" - INSTALLATION CHECK
  5798.     AX = 4B25h
  5799. Return: DI = 1234h if resident
  5800. SeeAlso: AX=4B21h,AX=4B40h
  5801. --------v-214B40-----------------------------
  5802. INT 21 - VIRUS - "Plastique"/"AntiCad" - INSTALLATION CHECK
  5803.     AX = 4B40h
  5804. Return: AX = 5678h if resident
  5805. SeeAlso: AX=4B25h,AX=4B41h,AX=4B4Ah
  5806. --------v-214B41-----------------------------
  5807. INT 21 - VIRUS - "Plastique"/"AntiCad" - ???
  5808.     AX = 4B41h
  5809.     ???
  5810. Return: ???
  5811. SeeAlso: AX=4B40h
  5812. --------v-214B4A-----------------------------
  5813. INT 21 - VIRUS - "Jabberwocky" - INSTALLATION CHECK
  5814.     AX = 4B4Ah
  5815. Return: AL = 57h if resident
  5816. SeeAlso: AX=4B40h,AX=4B4Bh
  5817. --------v-214B4B-----------------------------
  5818. INT 21 - VIRUS - "Horse-2" - INSTALLATION CHECK
  5819.     AX = 4B4Bh
  5820. Return: CF clear if resident
  5821. SeeAlso: AX=4B4Ah,AX=4B4Dh
  5822. --------v-214B4D-----------------------------
  5823. INT 21 - VIRUS - "Murphy-2", "Patricia"/"Smack" - INSTALLATION CHECK
  5824.     AX = 4B4Dh
  5825. Return: CF clear if resident
  5826. SeeAlso: AX=4B4Ah,AX=4B50h
  5827. --------v-214B50-----------------------------
  5828. INT 21 - VIRUS - "Plastique-2576"/"AntiCad-2576" - INSTALLATION CHECK
  5829.     AX = 4B50h
  5830. Return: AX = 1234h if resident
  5831. SeeAlso: AX=4B4Dh,AX=4B53h,AX=4B60h
  5832. --------v-214B53-----------------------------
  5833. INT 21 - VIRUS - "Horse" - INSTALLATION CHECK
  5834.     AX = 4B53h
  5835. Return: CF clear if resident
  5836. SeeAlso: AX=4B50h,AX=4B53h/BX=2121h,AX=4B55h
  5837. --------v-214B53BX2121-----------------------
  5838. INT 21 - VIRUS - "One Half" - INSTALLATION CHECK
  5839.     AX = 4B53h
  5840.     BX = 2121h
  5841.     CX = 1212h
  5842.     DX = 0236h
  5843. Return: AX = 454Bh if installed
  5844. SeeAlso: AX=4B50h,AX=4B53h,AX=4B55h
  5845. --------v-214B55-----------------------------
  5846. INT 21 - VIRUS - "Sparse" - INSTALLATION CHECK
  5847.     AX = 4B55h
  5848. Return: AX = 1231h if resident
  5849. SeeAlso: AX=4B53h,AX=4B59h
  5850. --------v-214B59-----------------------------
  5851. INT 21 - VIRUS - "Murphy-1", "Murphy-4" - INSTALLATION CHECK
  5852.     AX = 4B59h
  5853. Return: CF clear if resident
  5854. SeeAlso: AX=4B50h,AX=4B5Eh
  5855. --------v-214B5E-----------------------------
  5856. INT 21 - VIRUS - "Brothers" - INSTALLATION CHECK
  5857.     AX = 4B5Eh
  5858. Return: CF clear if resident
  5859. SeeAlso: AX=4B59h,AX=4B87h
  5860. --------v-214B60-----------------------------
  5861. INT 21 - VIRUS - "Plastique-2576"/"AntiCad-2576" - ???
  5862.     AX = 4B60h
  5863.     ???
  5864. Return: ???
  5865. SeeAlso: AX=4B50h
  5866. --------O-214B80-----------------------------
  5867. INT 21 - DR-DOS v3.41 - EXEC KERNEL FILE WITHOUT RETURN???
  5868.     AX = 4B80h
  5869.     (details to follow in INTER52) !!!
  5870. --------v-214B87-----------------------------
  5871. INT 21 - VIRUS - "Shirley" - INSTALLATION CHECK
  5872.     AX = 4B87h
  5873. Return: AX = 6663h if resident
  5874. SeeAlso: AX=4B5Eh,AX=4B95h
  5875. --------v-214B95-----------------------------
  5876. INT 21 - VIRUS - "Zherkov-1882" - INSTALLATION CHECK
  5877.     AX = 4B95h
  5878. Return: AX = 1973h if resident
  5879. SeeAlso: AX=4B87h,AX=4BA7h
  5880. --------v-214BA7-----------------------------
  5881. INT 21 - VIRUS - "1876"/"Dash-em" - INSTALLATION CHECK
  5882.     AX = 4BA7h
  5883. Return: AX = B459h if resident
  5884. SeeAlso: AX=4B95h,AX=4BAAh
  5885. --------v-214BAA-----------------------------
  5886. INT 21 - VIRUS - "Nomenklatura" - INSTALLATION CHECK
  5887.     AX = 4BAAh
  5888. Return: CF clear if resident
  5889. SeeAlso: AX=4BA7h,AX=4BAFh
  5890. --------v-214BAF-----------------------------
  5891. INT 21 - VIRUS - "948"/"Screenplus1", "Magnitogorsk" - INSTALLATION CHECK
  5892.     AX = 4BAFh
  5893. Return: AL = AFh if "Magnitogorsk" resident
  5894.     AL = FAh if "948"/"Screenplus1" resident
  5895. SeeAlso: AX=4BAAh,AX=4BDDh
  5896. --------v-214BDD-----------------------------
  5897. INT 21 - VIRUS - "Lozinsky"/"Zherkov" - INSTALLATION CHECK
  5898.     AX = 4BDDh
  5899. Return: AX = 1234h
  5900. SeeAlso: AX=4BAFh,AX=4BFEh
  5901. --------v-214BEE-----------------------------
  5902. INT 21 - F-DRIVER.SYS v1.14+ - GRAB INT 21
  5903.     AX = 4BEEh
  5904. Return: AX = status
  5905.         1234h grab was successful
  5906.         2345h failed (INT 21 grabbed previously)
  5907. Program: F-DRIVER.SYS is part of the shareware F-PROT virus/trojan protection
  5908.       package by Fridrik Skulason
  5909. Note:    when called the first time, this function moves the INT 21 monitoring
  5910.       code from its original location in the INT 21 chain to be the first
  5911.       thing called by INT 21.  This is the mechanism used by F-NET.
  5912. SeeAlso: INT 2F/AX=4653h
  5913. --------k-214BF0-----------------------------
  5914. INT 21 - DIET v1.10+ (Overlay Mode) - INSTALLATION CHECK
  5915.     AX = 4BF0h
  5916. Return: CF clear if installed
  5917.         AX = 899Dh
  5918. Program: DIET is an executable-compression program by Teddy Matsumoto
  5919. SeeAlso: AX=37D0h,AX=4BF1h
  5920. --------k-214BF1-----------------------------
  5921. INT 21 - DIET v1.10+ (Overlay Mode) - EXPAND PROGRAM???
  5922.     AX = 4BF1h
  5923. Return: ???
  5924. SeeAlso: AX=37D0h,AX=4BF0h
  5925. --------v-214BF1-----------------------------
  5926. INT 21 - VIRUS - "Jerusalem 2" - INSTALLATION CHECK
  5927.     AX = 4BF1h
  5928. Return: AX = 1FB4h if resident
  5929. SeeAlso: AX=3Fh/BX=FEB0h"VIRUS",AX=4BDDh"VIRUS",AX=4BFEh"VIRUS"
  5930. --------v-214BFE-----------------------------
  5931. INT 21 - VIRUS - "Hitchcock", "Dark Avenger-1028", "1193" - INSTALLATION CHECK
  5932.     AX = 4BFEh
  5933. Return: AX = 1234h if "Hitchcock" or "Storm" resident
  5934.     AX = ABCDh if "1193"/"Copyright" resident
  5935.     DI = 55BBh if "Dark Avenger-1028" resident
  5936. SeeAlso: AX=4BDDh,AX=4BF1h"VIRUS",AX=4BFFh"Justice"
  5937. --------v-214BFF-----------------------------
  5938. INT 21 - VIRUS - "USSR-707", "Justice", "Europe 92" - INSTALLATION CHECK
  5939.     AX = 4BFFh
  5940. Return: BL = FFh if "USSR-707" resident
  5941.     DI = 55AAh if "Justice" resident
  5942.     AX = 1234h if "Hitchcock.1238" resident
  5943.     CF clear if "Europe 92" resident
  5944. SeeAlso: AX=4BFEh,AX=4BFFh"Cascade",AX=5252h
  5945. --------v-214BFFSI0000-----------------------
  5946. INT 21 - VIRUS - "Cascade" - INSTALLATION CHECK
  5947.     AX = 4BFFh
  5948.     SI = 0000h
  5949.     DI = 0000h
  5950. Return: DI = 55AAh if installed
  5951. SeeAlso: AX=4BFFh"Justice",AX=5252h
  5952. --------D-214C-------------------------------
  5953. INT 21 - DOS 2+ - "EXIT" - TERMINATE WITH RETURN CODE
  5954.     AH = 4Ch
  5955.     AL = return code
  5956. Return: never returns
  5957. Notes:    unless the process is its own parent (see #0691 at AH=26h, offset 16h
  5958.       in PSP), all open files are closed and all memory belonging to the
  5959.       process is freed
  5960.     all network file locks should be removed before calling this function
  5961. SeeAlso: AH=00h,AH=26h,AH=4Bh,AH=4Dh,INT 15/AH=12h/BH=02h,INT 20,INT 22
  5962. SeeAlso: INT 60/DI=0601h
  5963. --------m-214C57-----------------------------
  5964. INT 21 - Headroom - ???
  5965.     AX = 4C57h
  5966.     DS:DX -> target address
  5967. Note:    jumps to target address instead of terminating program
  5968. SeeAlso: AX=5758h
  5969. --------D-214D-------------------------------
  5970. INT 21 - DOS 2+ - GET RETURN CODE (ERRORLEVEL)
  5971.     AH = 4Dh
  5972. Return: AH = termination type
  5973.         00h normal (INT 20,INT 21/AH=00h, or INT 21/AH=4Ch)
  5974.         01h control-C abort
  5975.         02h critical error abort
  5976.         03h terminate and stay resident (INT 21/AH=31h or INT 27)
  5977.     AL = return code
  5978. Notes:    the word in which DOS stores the return code is cleared after being
  5979.       read by this function, so the return code can only be retrieved once
  5980.     COMMAND.COM stores the return code of the last external command it
  5981.       executed as ERRORLEVEL
  5982.     this call should not be used if the child was started with AX=4B04h;
  5983.       use AH=8Ah instead
  5984.     the following sequence will close a Virtual DOS Machine under OS/2 2.0
  5985.       through OS/2 Merlin (but may change in the future):
  5986.         MOV    AH,4Dh
  5987.         INT    21h
  5988.         HLT
  5989.         DB    02h,0FDh
  5990.       This sequence is the only way to close a specific VDM which was
  5991.       booted from floppy or a disk image.
  5992. SeeAlso: AH=4Bh,AH=4Ch,AH=8Ah
  5993. --------D-214E-------------------------------
  5994. INT 21 - DOS 2+ - "FINDFIRST" - FIND FIRST MATCHING FILE
  5995.     AH = 4Eh
  5996.     AL = special flag for use by APPEND (see note below)
  5997.     CX = file attribute mask (see #0731 at AX=4301h) (bits 0 and 5 ignored)
  5998.         0088h (Novell DOS 7) find first deleted file
  5999.     DS:DX -> ASCIZ file specification (may include path and wildcards)
  6000. Return: CF clear if successful
  6001.         Disk Transfer Area filled with FindFirst data block (see #0933)
  6002.     CF set on error
  6003.         AX = error code (02h,03h,12h) (see #0980 at AH=59h)
  6004. Notes:    for search attributes other than 08h, all files with at MOST the
  6005.       specified combination of hidden, system, and directory attributes
  6006.       will be returned.  Under DOS 2.x, searching for attribute 08h
  6007.       (volume label) will also return normal files, while under DOS 3.0+
  6008.       only the volume label (if any) will be returned.
  6009.     this call also returns successfully if given the name of a character
  6010.       device without wildcards.  DOS 2.x returns attribute 00h, size 0,
  6011.       and the current date and time.  DOS 3.0+ returns attribute 40h and
  6012.       the current date and time.
  6013.     immediately after an INT 2F/AX=B711h (APPEND return found name), the
  6014.       name at DS:DX will be overwritten; if AL=00h on entry, the actual
  6015.       found pathname will be stored, otherwise, the actual found path
  6016.       will be prepended to the original filespec without a path.
  6017.     under LANtastic, this call may be used to obtain a list of a server's
  6018.       shared resources by searching for "\\SERVER\*.*"; a list of printer
  6019.       resources may be obtained by searching for "\\SERVER\@*.*"
  6020.     under the FlashTek X-32 DOS extender, the filespec pointer is in DS:EDX
  6021. BUGS:    under DOS 3.x and 4.x, the second and subsequent calls to this function
  6022.       with a character device name (no wildcards) and search attributes
  6023.       which include the volume-label bit (08h) will fail unless there is
  6024.       an intervening DOS call which implicitly or explicity performs a
  6025.       directory search without the volume-label bit.  Such implicit
  6026.       searches are performed by CREATE (AH=3Ch), OPEN (AH=3Dh), UNLINK
  6027.       (AH=41h), and RENAME (AH=56h)
  6028.     DR DOS 3.41 and 5.0 return the Directory attribute for the volume label
  6029. SeeAlso: AH=11h,AH=4Fh,AX=4301h,AX=714Eh,AX=71A1h,AX=F257h/SF=02h
  6030. SeeAlso: INT 2F/AX=111Bh,INT 2F/AX=B711h
  6031.  
  6032. Format of FindFirst data block:
  6033. Offset    Size    Description    (Table 0933)
  6034. ---PC-DOS 3.10, PC-DOS 4.01, MS-DOS 3.2/3.3/5.0---
  6035.  00h    BYTE    drive letter (bits 0-6), remote if bit 7 set
  6036.  01h 11 BYTEs    search template
  6037.  0Ch    BYTE    search attributes
  6038. ---DOS 2.x (and some DOS 3.x???)---
  6039.  00h    BYTE    search attributes
  6040.  01h    BYTE    drive letter
  6041.  02h 11 BYTEs    search template
  6042. ---WILDUNIX.COM---
  6043.  00h 12 BYTEs    15-character wildcard search pattern and drive letter (packed)
  6044.  0Ch    BYTE    search attributes
  6045. ---DOS 2.x and most 3.x---
  6046.  0Dh    WORD    entry count within directory
  6047.  0Fh    DWORD    pointer to DTA???
  6048.  13h    WORD    cluster number of start of parent directory
  6049. ---PC-DOS 4.01, MS-DOS 3.2/3.3/5.0---
  6050.  0Dh    WORD    entry count within directory
  6051.  0Fh    WORD    cluster number of start of parent directory
  6052.  11h  4 BYTEs    reserved
  6053. ---OS/2 MVDM---
  6054.  00h    WORD    "OS2_BMP_handle"
  6055.  02h    WORD    "OS2_LastEnt"
  6056.  04h    DWORD    "OS2_Checksum"
  6057.  08h    BYTE    "OS2_usi_flag"
  6058.  09h    DWORD    used by DOS emulator for second pass for volume-label searches
  6059.  0Dh    WORD    (ret) "DOS_LastEnt" entry count within directory
  6060.  0Fh    BYTE    OS/2 Processed-FindFirst flag
  6061.         00h FindFirst processed by DOS
  6062.         42h FindFirst processed by OS/2
  6063.  10h  5 BYTEs    reserved for future use
  6064. ---all versions, documented fields---
  6065.  15h    BYTE    attribute of file found
  6066.  16h    WORD    file time (see #0971 at AX=5700h)
  6067.  18h    WORD    file date (see #0972 at AX=5700h)
  6068.  1Ah    DWORD    file size
  6069.  1Eh 13 BYTEs    ASCIZ filename+extension
  6070. --------f-214E-------------------------------
  6071. INT 21 - WILDUNIX.COM internal - INSTALLATION CHECK
  6072.     AH = 4Eh
  6073.     DS:DX = 0000h:0000h
  6074. Return: AH = 99h if installed
  6075. Program: WILDUNIX.COM is a resident Unix-style wildcard expander by Steve
  6076.       Hosgood and Terry Barnaby
  6077. --------D-214F-------------------------------
  6078. INT 21 - DOS 2+ - "FINDNEXT" - FIND NEXT MATCHING FILE
  6079.     AH = 4Fh
  6080.     Disk Transfer Area contains data block from previous FindFirst or
  6081.       FindNext call
  6082. Return: CF clear if successful
  6083.         Disk Transfer Area updated
  6084.     CF set on error
  6085.         AX = error code (12h) (see #0980 at AH=59h)
  6086. Notes:    under Novell DOS 7, if the FindFirst call (AH=4Eh) had CX=0088h, then
  6087.       the next matching deleted file will be returned
  6088.     since the entire state of a FindFirst/FindNext sequence is contained
  6089.       in the data block in the DTA, other disk operations such as renaming,
  6090.       moving, deleting, or creating files can cause inaccurate directory
  6091.       searches, such as finding the same file twice
  6092. BUG:    DR DOS 3.41 and 5.0 return the Directory attribute for the volume label
  6093. SeeAlso: AH=12h,AH=4Eh,AX=714Fh,AX=71A1h
  6094. --------D-2150-------------------------------
  6095. INT 21 - DOS 2+ internal - SET CURRENT PROCESS ID (SET PSP ADDRESS)
  6096.     AH = 50h
  6097.     BX = segment of PSP for new process
  6098. Notes:    DOS uses the current PSP address to determine which processes own files
  6099.       and memory; it corresponds to process identifiers used by other OSs
  6100.     under DOS 2.x, this function cannot be invoked inside an INT 28h
  6101.       handler without setting the Critical Error flag
  6102.     under MS-DOS 3.0+ and DR DOS 3.41+, this function does not use any of
  6103.       the DOS-internal stacks and may thus be called at any time, even
  6104.       during another INT 21h call
  6105.     some Microsoft applications such as Quick C 2.51 use segments of 0000h
  6106.       and FFFFh and direct access to the SDA (see #0987 at AX=5D06h) to
  6107.       test whether they are running under MS-DOS rather than a compatible
  6108.       OS; although one should only call this function with valid PSP
  6109.       addresses, any program hooking it should be prepared to handle
  6110.       invalid addresses
  6111.     this function is supported by the OS/2 compatibility box
  6112.     this call was undocumented prior to the release of DOS 5.0
  6113. SeeAlso: AH=26h,AH=51h,AH=62h
  6114. --------v-2150FD-----------------------------
  6115. INT 21 - VIRUS - "Predator 2" - INSTALLATION CHECK
  6116.     AX = 50FDh
  6117. Return: AX = FD50h if resident
  6118. SeeAlso: AX=4BFFh"VIRUS",AX=5454h"VIRUS"
  6119. --------D-2151-------------------------------
  6120. INT 21 - DOS 2+ internal - GET CURRENT PROCESS ID (GET PSP ADDRESS)
  6121.     AH = 51h
  6122. Return: BX = segment of PSP for current process
  6123. Notes:    DOS uses the current PSP address to determine which processes own files
  6124.       and memory; it corresponds to process identifiers used by other OSs
  6125.     under DOS 2.x, this function cannot be invoked inside an INT 28h
  6126.       handler without setting the Critical Error flag
  6127.     under DOS 3.0+, this function does not use any of the DOS-internal
  6128.       stacks and may thus be called at any time, even during another
  6129.       INT 21h call
  6130.     supported by OS/2 compatibility box
  6131.     identical to the documented AH=62h
  6132.     this call was undocumented prior to the release of DOS 5.0
  6133. SeeAlso: AH=26h,AH=50h,AH=62h
  6134. --------D-2152-------------------------------
  6135. INT 21 U - DOS 2+ internal - "SYSVARS" - GET LIST OF LISTS
  6136.     AH = 52h
  6137. Return: ES:BX -> DOS list of lists (see #0934)
  6138. Notes:    partially supported by OS/2 v1.1 compatibility box (however, most
  6139.       pointers are FFFFh:FFFFh, LASTDRIVE is FFh, and the NUL header "next"
  6140.       pointer is FFFFh:FFFFh).
  6141.     partially supported by the Windows NT DOS box; contains only a
  6142.       rudimentary Current Directory Structure (see #0952)
  6143.     on return, ES points at the DOS data segment (see also INT 2F/AX=1203h)
  6144.     Quarterdeck's suggested check for the use of its DOSDATA.SYS or
  6145.       DOS-UP.SYS is to test whether the list-of-lists segment is greater
  6146.       than the segment of the first memory block; a better check for
  6147.       DOS-UP.SYS is INT 21/AX=2B01h/CX=444Dh
  6148.     because not all DOS workalikes support all fields in the List of Lists,
  6149.       applications should ensure that pointers are neither 0000h:0000h
  6150.       nor FFFFh:FFFFh before using them
  6151. SeeAlso: INT 2F/AX=1203h
  6152.  
  6153. Format of List of Lists:
  6154. Offset    Size    Description    (Table 0934)
  6155.  -24    WORD    (DOS 3.1+) contents of CX from INT 21/AX=5E01h
  6156.  -22    WORD    (DOS ???+) LRU counter for FCB caching
  6157.  -20    WORD    (DOS ???+) LRU counter for FCB opens
  6158.  -18    DWORD    (DOS ???+) address of OEM function handler (see INT 21/AH=F8h)
  6159.             FFFFh:FFFFh if not installed or not available
  6160.  -14    WORD    (DOS ???+) offset in DOS CS of code to return from INT 21 call
  6161.  -12    WORD    (DOS 3.1+) sharing retry count (see AX=440Bh)
  6162.  -10    WORD    (DOS 3.1+) sharing retry delay (see AX=440Bh)
  6163.  -8    DWORD    (DOS 3.0+) pointer to current disk buffer
  6164.  -4    WORD    (DOS 3.0+) pointer in DOS data segment of unread CON input
  6165.         when CON is read via a handle, DOS reads an entire line,
  6166.           and returns the requested portion, buffering the rest
  6167.           for the next read.  0000h indicates no unread input
  6168.  -2    WORD    segment of first memory control block (see #0935)
  6169.  00h    DWORD    pointer to first Drive Parameter Block (see #0708 at AH=32h)
  6170.  04h    DWORD    -> first System File Table (see #0946,#0947,#0948,#0949)
  6171.  08h    DWORD    pointer to active CLOCK$ device's header (most recently loaded
  6172.           driver with CLOCK bit set)
  6173.  0Ch    DWORD    pointer to active CON device's header (most recently loaded
  6174.           driver with STDIN bit set)
  6175. ---DOS 2.x---
  6176.  10h    BYTE    number of logical drives in system
  6177.  11h    WORD    maximum bytes/block of any block device
  6178.  13h    DWORD    pointer to first disk buffer (see #0956,#0957)
  6179.  17h 18 BYTEs    actual NUL device driver header (not a pointer!)
  6180.         NUL is always the first device on DOS's linked list of device
  6181.           drivers. (see #0953)
  6182. ---DOS 3.0---
  6183.  10h    BYTE    number of block devices
  6184.  11h    WORD    maximum bytes/block of any block device
  6185.  13h    DWORD    pointer to first disk buffer (see #0957,#0959)
  6186.  17h    DWORD    pointer to array of current directory structures (see #0950)
  6187.  1Bh    BYTE    value of LASTDRIVE command in CONFIG.SYS (default 5)
  6188.  1Ch    DWORD    pointer to STRING= workspace area
  6189.  20h    WORD    size of STRING area (the x in STRING=x from CONFIG.SYS)
  6190.  22h    DWORD    pointer to FCB table
  6191.  26h    WORD    the y in FCBS=x,y from CONFIG.SYS
  6192.  28h 18 BYTEs    actual NUL device driver header (not a pointer!)
  6193.         NUL is always the first device on DOS's linked list of device
  6194.           drivers. (see #0953)
  6195. ---DOS 3.1-3.3---
  6196.  10h    WORD    maximum bytes per sector of any block device
  6197.  12h    DWORD    pointer to first disk buffer in buffer chain (see #0957)
  6198.  16h    DWORD    pointer to array of current directory structures (see #0950)
  6199.  1Ah    DWORD    pointer to system FCB tables (see #0947,#0948,#0949)
  6200.  1Eh    WORD    number of protected FCBs (the y in the CONFIG.SYS FCBS=x,y)
  6201.  20h    BYTE    number of block devices installed
  6202.  21h    BYTE    number of available drive letters (largest of 5, installed
  6203.           block devices, and CONFIG.SYS LASTDRIVE=).  Also size of
  6204.           current directory structure array.
  6205.  22h 18 BYTEs    actual NUL device driver header (not a pointer!)
  6206.         NUL is always the first device on DOS's linked list of device
  6207.           drivers. (see #0953)
  6208.  34h    BYTE    number of JOIN'ed drives
  6209. ---DOS 4.x---
  6210.  10h    WORD    maximum bytes per sector of any block device
  6211.  12h    DWORD    pointer to disk buffer info record (see #0959,#0960)
  6212.         Note: although the initialization code in IO.SYS uses this
  6213.           pointer, MSDOS.SYS does not, instead using the hardcoded
  6214.           address of the info record
  6215.  16h    DWORD    pointer to array of current directory structures
  6216.         (see #0950,#0951)
  6217.  1Ah    DWORD    pointer to system FCB tables (see #0947,#0948,#0949)
  6218.  1Eh    WORD    number of protected FCBs (the y in the CONFIG.SYS FCBS=x,y)
  6219.         (always 00h for DOS 5.0)
  6220.  20h    BYTE    number of block devices installed
  6221.  21h    BYTE    number of available drive letters (largest of 5, installed
  6222.           block devices, and CONFIG.SYS LASTDRIVE=).  Also size of
  6223.           current directory structure array.
  6224.  22h 18 BYTEs    actual NUL device driver header (not a pointer!)
  6225.         NUL is always the first device on DOS's linked list of device
  6226.           drivers. (see #0953)
  6227.  34h    BYTE    number of JOIN'ed drives
  6228.  35h    WORD    pointer within IBMDOS code segment to list of special program
  6229.           names (see #0969)
  6230.         (always 0000h for DOS 5.0)
  6231.  37h    DWORD    pointer to FAR routine for resident IFS utility functions
  6232.         (see #0965)
  6233.         may be called by any IFS driver which does not wish to
  6234.           service functions 20h or 24h-28h itself
  6235.  3Bh    DWORD    pointer to chain of IFS (installable file system) drivers
  6236.  3Fh    WORD    the x in BUFFERS x,y (rounded up to multiple of 30 if in EMS)
  6237.  41h    WORD    number of lookahead buffers (the y in BUFFERS x,y)
  6238.  43h    BYTE    boot drive (1=A:)
  6239.  44h    BYTE    flag: 01h to use DWORD moves (80386+), 00h otherwise
  6240.  45h    WORD    extended memory size in KB
  6241. ---DOS 5.0-6.0---
  6242.  10h 39 BYTEs    as for DOS 4.x (see above)
  6243.  37h    DWORD    pointer to SETVER program list or 0000h:0000h
  6244.  3Bh    WORD    (DOS=HIGH) offset in DOS CS of function to fix A20 control
  6245.           when executing special .COM format
  6246.  3Dh    WORD    PSP of most-recently EXECed program if DOS in HMA, 0000h if low
  6247.         used for maintaining count of INT 21 calls which disable A20
  6248.           on return
  6249.  3Fh  8 BYTEs    as for DOS 4.x (see above)
  6250. ---Windows NT DOS Box---
  6251.  10h  6 BYTEs    ???
  6252.  16h    DWORD    pointer to array of current directory structures (see #0952)
  6253.  1Ah  6 BYTEs    ???
  6254.  20h    BYTE    number of block devices installed
  6255.  21h    BYTE    number of local drive letters (= installed block devices)
  6256.         Also size of current directory structure array.
  6257.  22h 18 BYTEs    actual NUL device driver header (not a pointer!)
  6258.         NUL is always the first device on DOS's linked list of device
  6259.           drivers. (see #0953)
  6260.  
  6261. Format of DOS memory control block:
  6262. Offset    Size    Description    (Table 0935)
  6263.  00h    BYTE    block type: 5Ah if last block in chain, otherwise 4Dh
  6264.  01h    WORD    PSP segment of owner or special flag value (see #0936)
  6265.  03h    WORD    size of memory block in paragraphs
  6266.  05h  3 BYTEs    unused by MS-DOS
  6267.         (386MAX) if locked-out block, region start/prev region end
  6268. ---DOS 2.x,3.x---
  6269.  08h  8 BYTEs    unused
  6270. ---DOS 4.0+ ---
  6271.  08h  8 BYTEs    ASCII program name if PSP memory block or DR DOS UMB,
  6272.           else garbage
  6273.         null-terminated if less than 8 characters
  6274. Notes:    the next MCB is at segment (current + size + 1)
  6275.     under DOS 3.1+, the first memory block is the DOS data segment,
  6276.       containing installable drivers, buffers, etc.     Under DOS 4.0+ it is
  6277.       divided into subsegments, each with its own memory control block
  6278.       (see #0940), the first of which is at offset 0000h.
  6279.     for DOS 5+, blocks owned by DOS may have either "SC" or "SD" in bytes
  6280.       08h and 09h.    "SC" is system code or locked-out inter-UMB memory,
  6281.       "SD" is system data, device drivers, etc.
  6282.     Some versions of DR DOS use only seven characters of the program name,
  6283.       placing a NUL in the eighth byte.
  6284. SeeAlso: #0937,#0939,#0940
  6285.  
  6286. (Table 0936)
  6287. Values for special flag PSP segments:
  6288.  0000h    free
  6289.  0006h    DR DOS XMS UMB
  6290.  0007h    DR DOS excluded upper memory ("hole")
  6291.  0008h    belongs to DOS
  6292.  FFF7h    386MAX v6.01+ ???
  6293.  FFFAh    386MAX UMB control block (see #0785 at AX=4402h"386MAX")
  6294.  FFFDh    386MAX locked-out memory
  6295.  FFFEh    386MAX UMB (normally immediately follows its control block)
  6296.  FFFFh    386MAX v6.01+ device driver
  6297.  
  6298. Format of MS-DOS 5+ UMB control block:
  6299. Offset    Size    Description    (Table 0937)
  6300.  00h    BYTE    type: 5Ah if last block in chain, 4Dh otherwise
  6301.  01h    WORD    first available paragraph in UMB if control block at start
  6302.           of UMB, 000Ah if control block at end of UMB
  6303.  03h    WORD    length in paragraphs of following UMB or locked-out region
  6304.  05h  3 BYTEs    unused
  6305.  08h  8 BYTEs    block type name: "UMB" if start block, "SM" if end block in UMB
  6306. SeeAlso: #0935,#0938
  6307.  
  6308. Format of MS-DOS 7.0 HMA memory control block:
  6309. Offset    Size    Description    (Table 0938)
  6310.  00h    WORD    signature "MS" (4Dh 53h)
  6311.  02h    WORD    usage flag???
  6312.         0000h free
  6313.         else ???
  6314.  04h    WORD    size of memory block in bytes (not counting MCB)
  6315.  06h    WORD    offset of next memory block in HMA or 0000h
  6316.  08h  8 BYTEs    unused (0)
  6317. SeeAlso: #0935,#0937,#0939
  6318.  
  6319. Format of STARLITE (General Software's Embedded DOS) memory control block:
  6320. Offset    Size    Description    (Table 0939)
  6321.  00h    BYTE    block type: 5Ah if last block in chain, otherwise 4Dh
  6322.  01h    WORD    PSP segment of owner, 0000h if free, 0008h if belongs to DOS
  6323.  03h    WORD    size of memory block in paragraphs
  6324.  05h    BYTE    unused
  6325.  06h    WORD    segment address of next memory control block (0000h if last)
  6326.  08h    WORD    segment address of previous memory control block or 0000h
  6327.  0Ah  6 BYTEs    reserved
  6328.  
  6329. Format of DOS 4.0+ data segment subsegment control blocks:
  6330. Offset    Size    Description    (Table 0940)
  6331.  00h    BYTE    subsegment type (blocks typically appear in this order)
  6332.         "D"  device driver
  6333.         "E"  device driver appendage
  6334.         "I"  IFS (Installable File System) driver
  6335.         "F"  FILES=  control block storage area (for FILES>5)
  6336.         "X"  FCBS=   control block storage area, if present
  6337.         "C"  BUFFERS EMS workspace area (if BUFFERS /X option used)
  6338.         "B"  BUFFERS=  storage area
  6339.         "L"  LASTDRIVE=     current directory structure array storage area
  6340.         "S"  STACKS=  code and data area, if present (see #0941,#0942)
  6341.         "T"  INSTALL= transient code
  6342.  01h    WORD    paragraph of subsegment start (usually the next paragraph)
  6343.  03h    WORD    size of subsegment in paragraphs
  6344.  05h  3 BYTEs    unused
  6345.  08h  8 BYTEs    for types "D" and "I", base name of file from which the driver
  6346.           was loaded (unused for other types)
  6347.  
  6348. Format of data at start of STACKS code segment (if present):
  6349. Offset    Size    Description    (Table 0941)
  6350.  00h    WORD    ???
  6351.  02h    WORD    number of stacks (the x in STACKS=x,y)
  6352.  04h    WORD    size of stack control block array (should be 8*x)
  6353.  06h    WORD    size of each stack (the y in STACKS=x,y)
  6354.  08h    DWORD    pointer to STACKS data segment
  6355.  0Ch    WORD    offset in STACKS data segment of stack control block array
  6356.  0Eh    WORD    offset in STACKS data segment of last element of that array
  6357.  10h    WORD    offset in STACKS data segment of the entry in that array for
  6358.           the next stack to be allocated (initially same as value in
  6359.           0Eh and works its way down in steps of 8 to the value in
  6360.           0Ch as hardware interrupts pre-empt each other)
  6361. Note:    the STACKS code segment data may, if present, be located as follows:
  6362.     DOS 3.2:    The code segment data is at a paragraph boundary fairly early
  6363.           in the IBMBIO segment (seen at 0070:0190h)
  6364.     DOS 3.3:    The code segment is at a paragraph boundary in the DOS data
  6365.           segment, which may be determined by inspecting the segment
  6366.           pointers of the vectors for those of interrupts 02h, 08h-0Eh,
  6367.           70h, 72-77h which have not been redirected by device drivers
  6368.           or TSRs.
  6369.     DOS 4.0+    Identified by sub-segment control block type "S" within the DOS
  6370.           data segment.
  6371. SeeAlso: #0943,INT B4"STACKMAN"
  6372.  
  6373. Format of array elements in STACKS data segment:
  6374. Offset    Size    Description    (Table 0942)
  6375.  00h    BYTE    status: 00h=free, 01h=in use, 03h=corrupted by overflow of
  6376.           higher stack.
  6377.  01h    BYTE    not used
  6378.  02h    WORD    previous SP
  6379.  04h    WORD    previous SS
  6380.  06h    WORD    ptr to word at top of stack (new value for SP). The word at the
  6381.           top of the stack is preset to point back to this control
  6382.           block.
  6383.  
  6384. Format of SHARE.EXE hooks (DOS 3.1-6.00):
  6385. Offset    Size    Description    (Table 0943)
  6386. (offsets from first system file table--pointed at by ListOfLists+04h)
  6387. -3Ch    DWORD    pointer to FAR routine for ???
  6388.         Note: not called by MS-DOS 3.3, set to 0000h:0000h by
  6389.             SHARE 3.3+
  6390. -38h    DWORD    pointer to FAR routine called on opening file
  6391.         on call, internal DOS location points at filename
  6392.           (see #0987 at AX=5D06h)
  6393.         Return: CF clear if successful
  6394.             CF set on error
  6395.                 AX = DOS error code (24h) (see #0980 at AH=59h)
  6396.         Note: SHARE directly accesses DOS-internal data to get name of
  6397.             file just opened
  6398. -34h    DWORD    pointer to FAR routine called on closing file
  6399.         ES:DI -> system file table
  6400.         Note: does something to every Record Lock Record for file
  6401. -30h    DWORD    pointer to FAR routine to close all files for given computer
  6402.         (called by AX=5D03h)
  6403. -2Ch    DWORD    pointer to FAR routine to close all files for given process
  6404.         (called by AX=5D04h)
  6405. -28h    DWORD    pointer to FAR routine to close file by name
  6406.         (called by AX=5D02h)
  6407.         DS:SI -> DOS parameter list (see #0986 at AX=5D00h)
  6408.            DPL's DS:DX -> name of file to close
  6409.         Return: CF clear if successful
  6410.             CF set on error
  6411.                 AX = DOS error code (03h) (see #0980 at AH=59h)
  6412. -24h    DWORD    pointer to FAR routine to lock region of file
  6413.         call with BX = file handle
  6414.               ---DOS 3.x---
  6415.               CX:DX = starting offset
  6416.               SI:AX = size
  6417.               ---DOS 4.0+ ---
  6418.               DS:DX -> lock range
  6419.                     DWORD start offset
  6420.                     DWORD size in bytes
  6421.         Return: CF set on error
  6422.                 AL = DOS error code (21h) (see #0980 at AH=59h)
  6423.         Note: not called if file is marked as remote
  6424. -20h    DWORD    pointer to FAR routine to unlock region of file
  6425.         call with BX = file handle
  6426.               ---DOS 3.x---
  6427.               CX:DX = starting offset
  6428.               SI:AX = size
  6429.               ---DOS 4.0+ ---
  6430.               DS:DX -> lock range
  6431.                     DWORD start offset
  6432.                     DWORD size in bytes
  6433.         Return: CF set on error
  6434.                 AL = DOS error code (21h) (see #0980 at AH=59h)
  6435.         Note: not called if file is marked as remote
  6436. -1Ch    DWORD    pointer to FAR routine to check if file region is locked
  6437.         call with ES:DI -> system file table entry for file
  6438.             CX = length of region from current position in file
  6439.         Return: CF set if any portion of region locked
  6440.                 AX = 0021h
  6441. -18h    DWORD    pointer to FAR routine to get open file list entry
  6442.         (called by AX=5D05h)
  6443.         call with DS:SI -> DOS parameter list (see #0986 at AX=5D00h)
  6444.             DPL's BX = index of sharing record
  6445.             DPL's CX = index of SFT in SFT chain of sharing rec
  6446.         Return: CF set on error or not loaded
  6447.                 AX = DOS error code (12h) (see #0980 at AH=59h)
  6448.             CF clear if successful
  6449.                 ES:DI -> filename
  6450.                 CX = number of locks owned by specified SFT
  6451.                 BX = network machine number
  6452.                 DX destroyed
  6453. -14h    DWORD    pointer to FAR routine for updating FCB from SFT???
  6454.         call with DS:SI -> unopened FCB
  6455.               ES:DI -> system file table entry
  6456.         Return: BL = C0h???
  6457.         Note: copies following fields from SFT to FCB:
  6458.            starting cluster of file      0Bh     1Ah
  6459.            sharing record offset      33h     1Ch
  6460.            file attribute          04h     1Eh
  6461. -10h    DWORD    pointer to FAR routine to get first cluster of FCB file ???
  6462.         call with ES:DI -> system file table entry
  6463.               DS:SI -> FCB
  6464.         Return: CF set if SFT closed or sharing record offsets
  6465.                 mismatched
  6466.             CF clear if successful
  6467.                 BX = starting cluster number from FCB
  6468. -0Ch    DWORD    pointer to FAR routine to close file if duplicate for process
  6469.         DS:SI -> system file table
  6470.         Return: AX = number of handle in JFT which already uses SFT
  6471.         Note: called during open/create of a file
  6472.         Note: if SFT was opened with inheritance enabled and sharing
  6473.             mode 111, does something to all other SFTs owned by
  6474.             same process which have the same file open mode and
  6475.             sharing record
  6476. -08h    DWORD    pointer to FAR routine for closing file
  6477.         Note: closes various handles referring to file most-recently
  6478.             opened
  6479. -04h    DWORD    pointer to FAR routine to update directory info in related SFT
  6480.           entries
  6481.         call with ES:DI -> system file table entry for file (see #0948)
  6482.               AX = subfunction (apply to each related SFT)
  6483.                 00h: update time stamp (offset 0Dh) and date
  6484.                      stamp (offset 0Fh)
  6485.                 01h: update file size (offset 11h) and starting
  6486.                      cluster (offset 0Bh).  Sets last-accessed
  6487.                      cluster fields to start of file if file
  6488.                      never accessed
  6489.                 02h: as function 01h, but last-accessed fields
  6490.                      always changed
  6491.                 03h: do both functions 00h and 02h
  6492.         Note: follows ptr at offset 2Bh in system file table entries
  6493.         Note: NOP if opened with no-inherit or via FCB
  6494. Notes:    most of the above hooks (except -04h, -14h, -18h, and -3Ch) assume
  6495.       either that SS=DOS DS or SS=DS=DOS DS and directly access
  6496.       DOS-internal data
  6497.     sharing hooks are not supported by DR DOS 5-6; they appear to be
  6498.       supported by Novell DOS 7, with a segment of 0000h indicating the
  6499.       DOS data segment
  6500. SeeAlso: #0944,#0945
  6501.  
  6502. Format of sharing record:
  6503. Offset    Size    Description    (Table 0944)
  6504.  00h    BYTE    flag
  6505.         00h free block
  6506.         01h allocated block
  6507.         FFh end marker
  6508.  01h    WORD    size of block
  6509.  03h    BYTE    checksum of pathname (including NUL)
  6510.         if sum of ASCII values is N, checksum is (N/256 + N%256)
  6511.  04h    WORD    offset in SHARE's DS of first Record Lock Record (see #0945)
  6512.  06h    DWORD    pointer to start of system file table chain for file
  6513.  0Ah    WORD    unique sequence number
  6514.  0Ch    var    ASCIZ full pathname
  6515. Note:    not supported by DR DOS SHARE 1.1 and 2.0; will reportedly be
  6516.       supported by Novell DOS 7
  6517. SeeAlso: #0943,#0945
  6518.  
  6519. Format of SHARE.EXE Record Lock Record:
  6520. Offset    Size    Description    (Table 0945)
  6521.  00h    WORD    offset in SHARE's DS of next lock table in list or 0000h
  6522.  02h    DWORD    offset in file of start of locked region
  6523.  06h    DWORD    offset in file of end of locked region
  6524.  0Ah    DWORD    pointer to System File Table entry for this file
  6525.  0Eh    WORD    PSP segment of lock's owner
  6526. ---DOS 5+ ---
  6527.  10h    WORD    lock type: (00h lock all, 01h lock writes only)
  6528. SeeAlso: #0943,#0944,#0946,#0949
  6529.  
  6530. Format of DOS 2.x system file tables:
  6531. Offset    Size    Description    (Table 0946)
  6532.  00h    DWORD    pointer to next file table (offset FFFFh if last)
  6533.  04h    WORD    number of files in this table
  6534.  06h  28h bytes per file
  6535.     Offset    Size    Description
  6536.      00h    BYTE    number of file handles referring to this file
  6537.      01h    BYTE    file open mode (see #0715 at AH=3Dh)
  6538.      02h    BYTE    file attribute
  6539.      03h    BYTE    drive (0 = character device, 1 = A, 2 = B, etc)
  6540.      04h 11 BYTEs    filename in FCB format (no path,no period,blank-padded)
  6541.      0Fh    WORD    ???
  6542.      11h    WORD    ???
  6543.      13h    DWORD    file size???
  6544.      17h    WORD    file date in packed format (see #0972 at AX=5700h)
  6545.      19h    WORD    file time in packed format (see #0971 at AX=5700h)
  6546.      1Bh    BYTE    device attribute (see #0734 at AX=4400h)
  6547.     ---character device---
  6548.      1Ch    DWORD    pointer to device driver
  6549.     ---block device---
  6550.      1Ch    WORD    starting cluster of file
  6551.      1Eh    WORD    relative cluster in file of last cluster accessed
  6552.     ------
  6553.      20h    WORD    absolute cluster number of current cluster
  6554.      22h    WORD    ???
  6555.      24h    DWORD    current file position???
  6556. SeeAlso: #0947,#0948,#0949
  6557.  
  6558. Format of DOS 3.0 system file tables and FCB tables:
  6559. Offset    Size    Description    (Table 0947)
  6560.  00h    DWORD    pointer to next file table (offset FFFFh if last)
  6561.  04h    WORD    number of files in this table
  6562.  06h  38h bytes per file
  6563.     Offset    Size    Description
  6564.      00h-1Eh as for DOS 3.1+ (see #0948)
  6565.      1Fh    WORD    byte offset of directory entry within sector
  6566.      21h 11 BYTEs    filename in FCB format (no path/period, blank-padded)
  6567.      2Ch    DWORD    (SHARE.EXE) pointer to previous SFT sharing same file
  6568.      30h    WORD    (SHARE.EXE) network machine number which opened file
  6569.             (Windows Enhanced mode DOSMGR uses the virtual machine
  6570.               ID as the machine number; see INT 2F/AX=1683h)
  6571.      32h    WORD    PSP segment of file's owner (first three entries for
  6572.               AUX/CON/PRN contain segment of IO.SYS startup code)
  6573.      34h    WORD    (SHARE.EXE) offset in SHARE code seg of share record
  6574.      36h    WORD    ??? apparently always 0000h
  6575. SeeAlso: #0946,#0948,#0949
  6576.  
  6577. Format of DOS 3.1-3.3x, DR DOS 5.0-6.0 system file tables and FCB tables:
  6578. Offset    Size    Description    (Table 0948)
  6579.  00h    DWORD    pointer to next file table (offset FFFFh if last)
  6580.  04h    WORD    number of files in this table
  6581.  06h  35h bytes per file
  6582.     Offset    Size    Description
  6583.      00h    WORD    number of file handles referring to this file
  6584.      02h    WORD    file open mode (see AX=6C00h, #0715 at AH=3Dh)
  6585.             bit 15 set if this file opened via FCB
  6586.      04h    BYTE    file attribute (see #0731 at AX=4301h)
  6587.      05h    WORD    device info word (see #0734 at AX=4400h)
  6588.             bit 15 set if remote file
  6589.             bit 14 set means do not set file date/time on closing
  6590.             bit 12 set means don't inherit on EXEC
  6591.             bits 5-0 drive number for disk files
  6592.      07h    DWORD    pointer to device driver header if character device
  6593.             else pointer to DOS Drive Parameter Block
  6594.               (see #0708 at AH=32h)
  6595.      0Bh    WORD    starting cluster of file
  6596.      0Dh    WORD    file time in packed format (see #0971 at AX=5700h)
  6597.             not used for character devices in DR DOS
  6598.      0Fh    WORD    file date in packed format (see #0972 at AX=5700h)
  6599.             not used for character devices in DR DOS
  6600.      11h    DWORD    file size
  6601.     ---system file table---
  6602.      15h    DWORD    current offset in file (may be larger than size of
  6603.               file; INT 21/AH=42h does not check new position)
  6604.     ---FCB table---
  6605.      15h    WORD    counter for last I/O to FCB
  6606.      17h    WORD    counter for last open of FCB
  6607.             (these are separate to determine the times of the
  6608.               latest I/O and open)
  6609.     ---
  6610.      19h    WORD    relative cluster within file of last cluster accessed
  6611.      1Bh    WORD    absolute cluster number of last cluster accessed
  6612.             0000h if file never read or written???
  6613.      1Dh    WORD    number of sector containing directory entry
  6614.             (see #0668)
  6615.      1Fh    BYTE    number of dir entry within sector (byte offset/32)
  6616.      20h 11 BYTEs    filename in FCB format (no path/period, blank-padded)
  6617.      2Bh    DWORD    (SHARE.EXE) pointer to previous SFT sharing same file
  6618.      2Fh    WORD    (SHARE.EXE) network machine number which opened file
  6619.             (Windows Enhanced mode DOSMGR uses the virtual machine
  6620.               ID as the machine number; see INT 2F/AX=1683h)
  6621.      31h    WORD    PSP segment of file's owner (see #0691 at AH=26h)
  6622.               (first three entries for AUX/CON/PRN contain segment
  6623.               of IO.SYS startup code)
  6624.      33h    WORD    offset within SHARE.EXE code segment of
  6625.               sharing record (see #0944)  0000h = none
  6626. SeeAlso: #0946,#0947,#0949
  6627.  
  6628. Format of DOS 4.0-6.0 system file tables and FCB tables:
  6629. Offset    Size    Description    (Table 0949)
  6630.  00h    DWORD    pointer to next file table (offset FFFFh if last)
  6631.  04h    WORD    number of files in this table
  6632.  06h  3Bh bytes per file
  6633.     Offset    Size    Description
  6634.      00h    WORD    number of file handles referring to this file
  6635.             FFFFh if in use but not referenced
  6636.      02h    WORD    file open mode (see AX=6C00h,#0715 at AH=3Dh)
  6637.             bit 15 set if this file opened via FCB
  6638.      04h    BYTE    file attribute (see #0731 at AX=4301h)
  6639.      05h    WORD    device info word (see also #0734 at AX=4400h)
  6640.             bit 15 set if remote file
  6641.             bit 14 set means do not set file date/time on closing
  6642.             bit 13 set if named pipe
  6643.             bit 12 set if no inherit
  6644.             bit 11 set if network spooler
  6645.             bit 7  set if device, clear if file (only if local)
  6646.             bits 6-0 as for AX=4400h
  6647.      07h    DWORD    pointer to device driver header if character device
  6648.             else pointer to DOS Drive Parameter Block
  6649.               (see #0708 at AH=32h) or REDIR data
  6650.      0Bh    WORD    starting cluster of file (local files only)
  6651.      0Dh    WORD    file time in packed format (see #0971)
  6652.      0Fh    WORD    file date in packed format (see #0972)
  6653.      11h    DWORD    file size
  6654.      15h    DWORD    current offset in file (SFT)
  6655.             LRU counters (FCB table, two WORDs)
  6656.     ---local file---
  6657.      19h    WORD    relative cluster within file of last cluster accessed
  6658.      1Bh    DWORD    number of sector containing directory entry
  6659.      1Fh    BYTE    number of dir entry within sector (byte offset/32)
  6660.     ---network redirector---
  6661.      19h    DWORD    pointer to REDIRIFS record
  6662.      1Dh  3 BYTEs    ???
  6663.     ------
  6664.      20h 11 BYTEs    filename in FCB format (no path/period, blank-padded)
  6665.      2Bh    DWORD    (SHARE.EXE) pointer to previous SFT sharing same file
  6666.      2Fh    WORD    (SHARE.EXE) network machine number which opened file
  6667.             (Windows Enhanced mode DOSMGR uses the virtual machine
  6668.               ID as the machine number; see INT 2F/AX=1683h)
  6669.      31h    WORD    PSP segment of file's owner (see #0691 at AH=26h)
  6670.               (first three entries for AUX/CON/PRN contain segment
  6671.               of IO.SYS startup code)
  6672.      33h    WORD    offset within SHARE.EXE code segment of
  6673.             sharing record (see #0902)  0000h = none
  6674.      35h    WORD    (local) absolute cluster number of last clustr accessed
  6675.             (redirector) ???
  6676.      37h    DWORD    pointer to IFS driver for file, 0000000h if native DOS
  6677. Note:    the OS/2 2.0 DOS Boot Session does not properly fill in the filename
  6678.       field due to incomplete support for SFTs; the OS/2 2.0 DOS Window
  6679.       does not appear to support SFTs at all
  6680. SeeAlso: #0946,#0947,#0948
  6681.  
  6682. Format of current directory structure (CDS) (array, LASTDRIVE entries):
  6683. Offset    Size    Description    (Table 0950)
  6684.  00h 67 BYTEs    ASCIZ path in form X:\PATH (local) or UNC form
  6685.           \\SERVER\PATH (network, see notes below)
  6686.  43h    WORD    drive attributes (see also note below and AX=5F07h)
  6687.         bit 15: uses network redirector     \ invalid if 00, installable
  6688.         bit 14: physical drive         / file system if 11
  6689.         bit 13: JOIN'ed      \ path above is true path that would be
  6690.         bit 12: SUBST'ed  / needed if not under SUBST or JOIN
  6691.         bit  7: remote drive hidden from redirector's assign-list and
  6692.               exempt from network connection make/break commands;
  6693.               set for CD-ROM drives by MSCDEX (not supported by
  6694.               CORELCDX)
  6695.  45h    DWORD    pointer to Drive Parameter Block for drive
  6696.           (see #0708 at AH=32h)
  6697. ---local drives---
  6698.  49h    WORD    starting cluster of current directory
  6699.         0000h = root, FFFFh = never accessed
  6700.  4Bh    WORD    ??? seems to be FFFFh always
  6701.  4Dh    WORD    ??? seems to be FFFFh always
  6702. ---network drives---
  6703.  49h    DWORD    pointer to redirector or REDIRIFS record, or FFFFh:FFFFh
  6704.         (DOS 4 only) available for use by IFS driver
  6705.  4Dh    WORD    stored user data from INT 21/AX=5F03h
  6706. ------
  6707.  4Fh    WORD    offset in current directory path of backslash corresponding to
  6708.           root directory for drive
  6709.         this value specifies how many characters to hide from the
  6710.           "CHDIR" and "GETDIR" calls; normally set to 2 to hide the
  6711.           drive letter and colon, SUBST, JOIN, and networks change it
  6712.           so that only the appropriate portion of the true path is
  6713.           visible to the user
  6714. ---DOS 4.0+ ---
  6715.  51h    BYTE    (DOS 4 only, remote drives) device type
  6716.         04h network drive
  6717.  52h    DWORD    pointer to IFS driver (DOS 4) or redirector block (DOS 5+) for
  6718.           this drive, 00000000h if native DOS
  6719.  56h    WORD    available for use by IFS driver
  6720. Notes:    the path for invalid drives is normally set to X:\, but may be empty
  6721.       after JOIN x: /D in DR DOS 5.0 or NET USE x: /D in older LAN versions
  6722.     normally, only one of bits 13&12 may be set together with bit 14, but
  6723.       DR DOS 5.0 uses other combinations for bits 15-12: 0111 JOIN,
  6724.       0001 SUBST, 0101 ASSIGN (see #0951)
  6725.     Windows for Workgroups 3.11 network sets the path to the local
  6726.       drive and directory even for network drives; in that case the
  6727.       UNC form \\SERVER\SHARE can be obtained with INT 21/AX=5F02h
  6728.       or INT 21/AX=5F46h. LapLink RemoteAccess does the same even for
  6729.       INT 21/AX=5F02h
  6730.     SoftWindows on the Macintosh PowerPC sets \\E for the host drive
  6731. SeeAlso: #0951,INT 21/AX=71AAh/BL=00h
  6732.  
  6733. Format of DR DOS 5.0-6.0 current directory structure entry (array):
  6734. Offset    Size    Description    (Table 0951)
  6735.  00h 67 BYTEs    ASCIZ pathname of actual root directory for this logical drive
  6736.  43h    WORD    drive attributes
  6737.         1000h SUBSTed drive
  6738.         3000h??? JOINed drive
  6739.         4000h physical drive
  6740.         5000h ASSIGNed drive
  6741.         7000h JOINed drive
  6742.         8000h network drive
  6743.  45h    BYTE    physical drive number (0=A:) if this logical drive is valid
  6744.  46h    BYTE    ??? apparently flags for JOIN and ASSIGN
  6745.  47h    WORD    cluster number of start of parent directory (0000h = root)
  6746.  49h    WORD    entry number of current directory in parent directory
  6747.  4Bh    WORD    cluster number of start of current directory
  6748.  4Dh    WORD    used for media change detection (details not available)
  6749.  4Fh    WORD    cluster number of SUBST/JOIN "root" directory
  6750.         0000h if physical root directory
  6751. SeeAlso: #0950
  6752.  
  6753. Format of Windows NT Current Directory Structure (CDS) (array):
  6754. Offset    Size    Description    (Table 0952)
  6755.  00h 67 BYTEs    ASCIZ path in form X:\ (does not show either current directory
  6756.           or network path)
  6757.  43h  4 BYTEs    ???
  6758. Note:    the WinNT CDS contains only as many entries as there are local drives,
  6759.       not LASTDRIVE entries.
  6760.  
  6761. Format of DOS device driver header:
  6762. Offset    Size    Description    (Table 0953)
  6763.  00h    DWORD    pointer to next driver, offset=FFFFh if last driver
  6764.  04h    WORD    device attributes (see #0954,#0955)
  6765.  06h    WORD    device strategy entry point
  6766.         call with ES:BX -> request header
  6767.           (see #1884 at INT 2F/AX=0802h)
  6768.  08h    WORD    device interrupt entry point
  6769. ---character device---
  6770.  0Ah  8 BYTEs    blank-padded character device name
  6771. ---block device---
  6772.  0Ah    BYTE    number of subunits (drives) supported by driver
  6773.  0Bh  7 BYTEs    normally unused; sometimes contains signature to indicate
  6774.           specific drivers:
  6775.         "$PCMATA"   PCMCIA driver PCMATA.SYS (see AX=440Dh)
  6776.         "AHADDVR"   Adaptec SCSI disk driver ASPIDISK.SYS
  6777.         "DBLSPAC"   MS DoubleSpace or DriveSpace
  6778.         "DSKREET"   NortonUtils v5+ Diskreet (see INT 2F/AX=FE00h)
  6779.         "GFS    "   LapLink III device driver DD.BIN
  6780.         "SIDExxx"   PCMCIA driver ATADRV.EXE (see AX=440Dh)
  6781.         "STAC-CD"   Stacker/Stacker Anywhere (see AX=4404h"Stacker")
  6782. ---DoubleSpace/DriveSpace---
  6783.  12h  2 BYTEs    signature ",." (2Ch 2Eh)
  6784.  14h    var    preloading API entry point
  6785. ---CD-ROM---
  6786.  12h    WORD    reserved, must be 0000h
  6787.         appears to be another device chain
  6788.  14h    BYTE    drive letter (must initially be 00h; this byte is set by
  6789.           MSCDEX when it loads)
  6790.  15h    BYTE    number of units
  6791.  16h  6 BYTEs    signature 'MSCDnn' where 'nn' is version (currently '00')
  6792. SeeAlso: #1839 at INT 25/AX=CDCDh,#2070 at INT 2F/AX=5600h
  6793.  
  6794. Bitfields for device attributes (character device):
  6795. Bit(s)    Description    (Table 0954)
  6796.  15    set (indicates character device)
  6797.  14    IOCTL supported (see AH=44h)
  6798.  13    (DOS 3.0+) output until busy supported
  6799.  12    reserved
  6800.  11    (DOS 3.0+) OPEN/CLOSE/RemMedia calls supported
  6801.  10-8    reserved
  6802.  7    (DOS 5.0+) Generic IOCTL check call supported (driver command 19h)
  6803.     (see AX=4410h,AX=4411h)
  6804.  6    (DOS 3.2+) Generic IOCTL call supported (driver command 13h)
  6805.     (see AX=440Ch,AX=440Dh)
  6806.  5    reserved
  6807.  4    device is special (use INT 29 "fast console output")
  6808.  3    device is CLOCK$ (all reads/writes use transfer record described
  6809.       below)
  6810.  2    device is NUL
  6811.  1    device is standard output
  6812.  0    device is standard input
  6813. Note:    for European MS-DOS 4.0, bit 11 also indicates that bits 8-6 contain a
  6814.       version code (000 = DOS 3.0,3.1; 001 = DOS 3.2;
  6815.       010 = European DOS 4.0)
  6816. SeeAlso: #0955,#0953
  6817.  
  6818. Bitfields for device attributes (block device):
  6819. Bit(s)    Description    (Table 0955)
  6820.  15    clear (indicates block device)
  6821.  14    IOCTL supported
  6822.  13    non-IBM format
  6823.  12    network device (device is remote)
  6824.  11    (DOS 3.0+) OPEN/CLOSE/RemMedia calls supported
  6825.  10    reserved
  6826.  9    direct I/O not allowed??? (set by DOS 3.3 DRIVER.SYS for "new" drives)
  6827.  8    ??? set by DOS 3.3 DRIVER.SYS for "new" drives
  6828.  7    (DOS 5.0+) Generic IOCTL check call supported (driver command 19h)
  6829.     (see AX=4410h,AX=4411h)
  6830.  6    (DOS 3.2+) Generic IOCTL call supported (driver command 13h)
  6831.     implies support for commands 17h and 18h
  6832.       (see AX=440Ch,AX=440Dh,AX=440Eh,AX=440Fh)
  6833.  5-2    reserved
  6834.  1    driver supports 32-bit sector addressing (DOS 3.31+)
  6835.  0     reserved
  6836. Note:    for European MS-DOS 4.0, bit 11 also indicates that bits 8-6 contain a
  6837.       version code (000 = DOS 3.0,3.1; 001 = DOS 3.2;
  6838.       010 = European DOS 4.0)
  6839. SeeAlso: #0954,#0953
  6840.  
  6841. Format of DOS 2.x disk buffer:
  6842. Offset    Size    Description    (Table 0956)
  6843.  00h    DWORD    pointer to next disk buffer, offset = FFFFh if last
  6844.         least-recently used buffer is first in chain
  6845.  04h    BYTE    drive (0=A, 1=B, etc), FFh if not in use
  6846.  05h  3 BYTEs    unused??? (seems always to be 00h 00h 01h)
  6847.  08h    WORD    logical sector number
  6848.  0Ah    BYTE    number of copies to write (1 for non-FAT sectors)
  6849.  0Bh    BYTE    sector offset between copies if multiple copies to be written
  6850.  0Ch    DWORD    pointer to DOS Drive Parameter Block (see #0708 at AH=32h)
  6851.  10h        buffered data
  6852. SeeAlso: #0957,#0959,#0960,#0962
  6853.  
  6854. Format of DOS 3.x disk buffer:
  6855. Offset    Size    Description    (Table 0957)
  6856.  00h    DWORD    pointer to next disk buffer, offset = FFFFh if last
  6857.         least-recently used buffer is first in chain
  6858.  04h    BYTE    drive (0=A,1=B, etc), FFh if not in use
  6859.  05h    BYTE    buffer flags (see #0958)
  6860.  06h    WORD    logical sector number
  6861.  08h    BYTE    number of copies to write (1 for non-FAT sectors)
  6862.  09h    BYTE    sector offset between copies if multiple copies to be written
  6863.  0Ah    DWORD    pointer to DOS Drive Parameter Block (see #0708 at AH=32h)
  6864.  0Eh    WORD    unused??? (almost always 0)
  6865.  10h        buffered data
  6866. SeeAlso: #0956,#0959,#0960,#0962
  6867.  
  6868. Bitfields for DOS 3.x disk buffer flags:
  6869. Bit(s)    Description    (Table 0958)
  6870.  7    ???
  6871.  6    buffer dirty
  6872.  5    buffer has been referenced
  6873.  4    ???
  6874.  3    sector in data area
  6875.  2    sector in a directory, either root or subdirectory
  6876.  1    sector in FAT
  6877.  0    boot sector??? (guess)
  6878. SeeAlso: #0963
  6879.  
  6880. Format of DOS 4.00 (pre UR 25066) disk buffer info:
  6881. Offset    Size    Description    (Table 0959)
  6882.  00h    DWORD    pointer to array of disk buffer hash chain heads (see #0961)
  6883.  04h    WORD    number of disk buffer hash chains (referred to as NDBCH below)
  6884.  06h    DWORD    pointer to lookahead buffer, zero if not present
  6885.  0Ah    WORD    number of lookahead sectors, else zero (the y in BUFFERS=x,y)
  6886.  0Ch    BYTE    00h if buffers in EMS (/X), FFh if not
  6887.  0Dh    WORD    EMS handle for buffers, zero if not in EMS
  6888.  0Fh    WORD    EMS physical page number used for buffers (usually 255)
  6889.  11h    WORD    ??? seems always to be 0001h
  6890.  13h    WORD    segment of EMS physical page frame
  6891.  15h    WORD    ??? seems always to be zero
  6892.  17h  4 WORDs    EMS partial page mapping information???
  6893. SeeAlso: #0956,#0957,#0960,#0964
  6894.  
  6895. Format of DOS 4.01 (from UR 25066 Corrctive Services Disk on) disk buffer info:
  6896. Offset    Size    Description    (Table 0960)
  6897.  00h    DWORD    pointer to array of disk buffer hash chain heads (see #0961)
  6898.  04h    WORD    number of disk buffer hash chains (referred to as NDBCH below)
  6899.  06h    DWORD    pointer to lookahead buffer, zero if not present
  6900.  0Ah    WORD    number of lookahead sectors, else zero (the y in BUFFERS=x,y)
  6901.  0Ch    BYTE    01h, possibly to distinguish from pre-UR 25066 format
  6902.  0Dh    WORD    ??? EMS segment for BUFFERS (only with /XD)
  6903.  0Fh    WORD    ??? EMS physical page number of EMS seg above (only with /XD)
  6904.  11h    WORD    ??? EMS segment for ??? (only with /XD)
  6905.  13h    WORD    ??? EMS physical page number of above (only with /XD)
  6906.  15h    BYTE    ??? number of EMS page frames present (only with /XD)
  6907.  16h    WORD    segment of one-sector workspace buffer allocated in main memory
  6908.           if BUFFERS/XS or /XD options in effect, possibly to avoid DMA
  6909.           into EMS
  6910.  18h    WORD    EMS handle for buffers, zero if not in EMS
  6911.  1Ah    WORD    EMS physical page number used for buffers (usually 255)
  6912.  1Ch    WORD    ??? appears always to be 0001h
  6913.  1Eh    WORD    segment of EMS physical page frame
  6914.  20h    WORD    ??? appears always to be zero
  6915.  22h    BYTE    00h if /XS, 01h if /XD, FFh if BUFFERS not in EMS
  6916. SeeAlso: #0956,#0957,#0959,#0964
  6917.  
  6918. Format of DOS 4.x disk buffer hash chain head (array, one entry per chain):
  6919. Offset    Size    Description    (Table 0961)
  6920.  00h    WORD    EMS logical page number in which chain is resident, -1 if not
  6921.           in EMS
  6922.  02h    DWORD    pointer to least recently used buffer header.  All buffers on
  6923.           this chain are in the same segment.
  6924.  06h    BYTE    number of dirty buffers on this chain
  6925.  07h    BYTE    reserved (00h)
  6926. Notes:    buffered disk sectors are assigned to chain N where N is the sector's
  6927.       address modulo NDBCH,     0 <= N <= NDBCH-1
  6928.     each chain resides completely within one EMS page
  6929.     this structure is in main memory even if buffers are in EMS
  6930.  
  6931. Format of DOS 4.0-6.0 disk buffer:
  6932. Offset    Size    Description    (Table 0962)
  6933.  00h    WORD    forward ptr, offset only, to next least recently used buffer
  6934.  02h    WORD    backward pointer, offset only
  6935.  04h    BYTE    drive (0=A,1=B, etc) if bit 7 clear
  6936.         SFT index if bit 7 set
  6937.         FFh if not in use
  6938.  05h    BYTE    buffer flags (see #0963)
  6939.  06h    DWORD    logical sector number (local buffers only)
  6940.  0Ah    BYTE    number of copies to write
  6941.         for FAT sectors, same as number of FATs
  6942.         for data and directory sectors, usually 1
  6943.  0Bh    WORD    offset in sectors between copies to write for FAT sectors
  6944.  0Dh    DWORD    pointer to DOS Drive Parameter Block (see #0708 at AH=32h)
  6945.  11h    WORD    size of data in buffer if remote buffer (see flags above)
  6946.  13h    BYTE    reserved (padding)
  6947.  14h        buffered data
  6948. Note:    for DOS 4.x, all buffered sectors which have the same hash value
  6949.       (computed as the sum of high and low words of the logical sector
  6950.       number divided by the number of disk buffer chains) are on the same
  6951.       doubly-linked circular chain; for DOS 5+, only a single circular
  6952.       chain exists.
  6953.     the links consist of offset addresses only, the segment being the same
  6954.       for all buffers in the chain.
  6955. SeeAlso: #0956,#0957,#0959
  6956.  
  6957. Bitfields for DOS 4.0-6.0 disk buffer flags:
  6958. Bit(s)    Description    (Table 0963)
  6959.  7    remote buffer
  6960.  6    buffer dirty
  6961.  5    buffer has been referenced (reserved in DOS 5+)
  6962.  4    search data buffer (only valid if remote buffer)
  6963.  3    sector in data area
  6964.  2    sector in a directory, either root or subdirectory
  6965.  1    sector in FAT
  6966.  0    reserved
  6967. SeeAlso: #0958
  6968.  
  6969. Format of DOS 5.0-6.0 disk buffer info:
  6970. Offset    Size    Description    (Table 0964)
  6971.  00h    DWORD    pointer to least-recently-used buffer header (may be in HMA)
  6972.         (see #0962)
  6973.  04h    WORD    number of dirty disk buffers
  6974.  06h    DWORD    pointer to lookahead buffer, zero if not present
  6975.  0Ah    WORD    number of lookahead sectors, else zero (the y in BUFFERS=x,y)
  6976.  0Ch    BYTE    buffer location
  6977.         00h base memory, no workspace buffer
  6978.         01h HMA, workspace buffer in base memory
  6979.  0Dh    DWORD    pointer to one-segment workspace buffer in base memory
  6980.  11h  3 BYTEs    unused
  6981.  14h    WORD    ???
  6982.  16h    BYTE    flag: INT 24 fail while making an I/O status call
  6983.  17h    BYTE    temp storage for user memory allocation strategy during EXEC
  6984.  18h    BYTE    counter: number of INT 21 calls for which A20 is off
  6985.  19h    BYTE    bit flags
  6986.         bit 0: ???
  6987.         bit 1: SWITCHES=/W specified in CONFIG.SYS (don't load
  6988.             WINA20.SYS when MS Windows 3.0 starts)
  6989.         bit 2: in EXEC state (INT 21/AX=4B05h)
  6990.  1Ah    WORD    offset of unpack code start (used only during INT 21/AX=4B05h)
  6991.  1Ch    BYTE    bit 0 set iff UMB MCB chain linked to normal MCB chain
  6992.  1Dh    WORD    minimum paragraphs of memory required by program being EXECed
  6993.  1Fh    WORD    segment of first MCB in upper memory blocks or FFFFh if DOS
  6994.           memory chain in base 640K only (first UMB MCB usually at
  6995.           9FFFh, locking out video memory with a DOS-owned memory
  6996.           block)
  6997.         the MCB this word points at contains a valid link into high
  6998.           memory even if it is marked with a 'Z' indicating the last
  6999.           memory block
  7000.  21h    WORD    paragraph from which to start scanning during memory allocation
  7001. SeeAlso: #0959,#0960
  7002.  
  7003. (Table 0965)
  7004. Call IFS utility function entry point with:
  7005.     AH = 20h miscellaneous functions
  7006.         AL = 00h get date
  7007.         Return: CX = year
  7008.             DH = month
  7009.             DL = day
  7010.         AL = 01h get process ID and computer ID
  7011.         Return: BX = current PSP segment
  7012.             DX = active network machine number
  7013.         AL = 05h get file system info
  7014.         ES:DI -> 16-byte info buffer
  7015.         Return: buffer filled
  7016.             Offset    Size    Description
  7017.              00h  2 BYTEs    unused
  7018.              02h    WORD    number of SFTs (actually counts only
  7019.                     the first two file table arrays)
  7020.              04h    WORD    number of FCB table entries
  7021.              06h    WORD    number of proctected FCBs
  7022.              08h  6 BYTEs    unused
  7023.              0Eh    WORD    largest sector size supported
  7024.         AL = 06h get machine name
  7025.         ES:DI -> 18-byte buffer for name
  7026.         Return: buffer filled with name starting at offset 02h
  7027.         AL = 08h get sharing retry count
  7028.         Return: BX = sharing retry count
  7029.         AL = other
  7030.         Return: CF set
  7031.     AH = 21h get redirection state
  7032.         BH = type (03h disk, 04h printer)
  7033.         Return: BH = state (00h off, 01h on)
  7034.     AH = 22h ??? some sort of time calculation
  7035.         AL = 00h ???
  7036.             nonzero ???
  7037.     AH = 23h ??? some sort of time calculation
  7038.     AH = 24h compare filenames
  7039.         DS:SI -> first ASCIZ filename
  7040.         ES:DI -> second ASCIZ filename
  7041.         Return: ZF set if files are same ignoring case and / vs \
  7042.     AH = 25h normalize filename
  7043.         DS:SI -> ASCIZ filename
  7044.         ES:DI -> buffer for result
  7045.         Return: filename uppercased, forward slashes changed to backslashes
  7046.     AH = 26h get DOS stack
  7047.         Return: DS:SI -> top of stack
  7048.             CX = size of stack in bytes
  7049.     AH = 27h increment InDOS flag
  7050.     AH = 28h decrement InDOS flag
  7051. Note:    IFS drivers which do not wish to implement functions 20h or 24h-28h may
  7052.       pass them on to the default handler pointed at by [LoL+37h]
  7053. SeeAlso: #0966,#0967
  7054.  
  7055. Format of IFS driver list:
  7056. Offset    Size    Description    (Table 0966)
  7057.  00h    DWORD    pointer to next driver header
  7058.  04h  8 BYTEs    IFS driver name (blank padded), as used by FILESYS command
  7059.  0Ch  4 BYTEs    ???
  7060.  10h    DWORD    pointer to IFS utility function entry point (see #0965)
  7061.         call with ES:BX -> IFS request (see #0967)
  7062.  14h    WORD    offset in header's segment of driver entry point
  7063.     ???
  7064. SeeAlso: #0965,#0967
  7065.  
  7066. Format of IFS request block:
  7067. Offset    Size    Description    (Table 0967)
  7068.  00h    WORD    total size in bytes of request
  7069.  02h    BYTE    class of request
  7070.         02h ???
  7071.         03h redirection
  7072.         04h ???
  7073.         05h file access
  7074.         06h convert error code to string
  7075.         07h ???
  7076.  03h    WORD    returned DOS error code
  7077.  05h    BYTE    IFS driver exit status
  7078.         00h success
  7079.         01h ???
  7080.         02h ???
  7081.         03h ???
  7082.         04h ???
  7083.         FFh internal failure
  7084.  06h 16 BYTEs    ???
  7085. ---request class 02h---
  7086.  16h    BYTE    function code
  7087.         04h ???
  7088.  17h    BYTE    unused???
  7089.  18h    DWORD    pointer to ???
  7090.  1Ch    DWORD    pointer to ???
  7091.  20h  2 BYTEs    ???
  7092. ---request class 03h---
  7093.  16h    BYTE    function code
  7094.  17h    BYTE    ???
  7095.  18h    DWORD    pointer to ???
  7096.  1Ch    DWORD    pointer to ???
  7097.  22h    WORD    returned ???
  7098.  24h    WORD    returned ???
  7099.  26h    WORD    returned ???
  7100.  28h    BYTE    returned ???
  7101.  29h    BYTE    unused???
  7102. ---request class 04h---
  7103.  16h    DWORD    pointer to ???
  7104.  1Ah    DWORD    pointer to ???
  7105. ---request class 05h---
  7106.  16h    BYTE    function code
  7107.         01h flush disk buffers
  7108.         02h get disk space
  7109.         03h MKDIR
  7110.         04h RMDIR
  7111.         05h CHDIR
  7112.         06h delete file
  7113.         07h rename file
  7114.         08h search directory
  7115.         09h file open/create
  7116.         0Ah LSEEK
  7117.         0Bh read from file
  7118.         0Ch write to file
  7119.         0Dh lock region of file
  7120.         0Eh commit/close file
  7121.         0Fh get/set file attributes
  7122.         10h printer control
  7123.         11h ???
  7124.         12h process termination
  7125.         13h ???
  7126.     ---class 05h function 01h---
  7127.      17h  7 BYTEs    ???
  7128.      1Eh    DWORD    pointer to ???
  7129.      22h  4 BYTEs    ???
  7130.      26h    BYTE    ???
  7131.      27h    BYTE    ???
  7132.     ---class 05h function 02h---
  7133.      17h  7 BYTEs    ???
  7134.      1Eh    DWORD    pointer to ???
  7135.      22h  4 BYTEs    ???
  7136.      26h    WORD    returned total clusters
  7137.      28h    WORD    returned sectors per cluster
  7138.      2Ah    WORD    returned bytes per sector
  7139.      2Ch    WORD    returned available clusters
  7140.      2Eh    BYTE    returned ???
  7141.      2Fh    BYTE    ???
  7142.     ---class 05h functions 03h,04h,05h---
  7143.      17h  7 BYTEs    ???
  7144.      1Eh    DWORD    pointer to ???
  7145.      22h  4 BYTEs    ???
  7146.      26h    DWORD    pointer to directory name
  7147.     ---class 05h function 06h---
  7148.      17h  7 BYTEs    ???
  7149.      1Eh    DWORD    pointer to ???
  7150.      22h  4 BYTEs    ???
  7151.      26h    WORD    attribute mask
  7152.      28h    DWORD    pointer to filename
  7153.     ---class 05h function 07h---
  7154.      17h  7 BYTEs    ???
  7155.      1Eh    DWORD    pointer to ???
  7156.      22h  4 BYTEs    ???
  7157.      26h    WORD    attribute mask
  7158.      28h    DWORD    pointer to source filespec
  7159.      2Ch    DWORD    pointer to destination filespec
  7160.     ---class 05h function 08h---
  7161.      17h  7 BYTEs    ???
  7162.      1Eh    DWORD    pointer to ???
  7163.      22h  4 BYTEs    ???
  7164.      26h    BYTE    00h FINDFIRST
  7165.             01h FINDNEXT
  7166.      28h    DWORD    pointer to FindFirst search data + 01h if FINDNEXT
  7167.      2Ch    WORD    search attribute if FINDFIRST
  7168.      2Eh    DWORD    pointer to filespec if FINDFIRST
  7169.     ---class 05h function 09h---
  7170.      17h  7 BYTEs    ???
  7171.      1Eh    DWORD    pointer to ???
  7172.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7173.      26h    WORD    ???  \ together, specify open vs. create, whether or
  7174.      28h    WORD    ???  / not to truncate
  7175.      2Ah  4 BYTEs    ???
  7176.      2Eh    DWORD    pointer to filename
  7177.      32h  4 BYTEs    ???
  7178.      36h    WORD    file attributes on call
  7179.             returned ???
  7180.      38h    WORD    returned ???
  7181.     ---class 05h function 0Ah---
  7182.      17h  7 BYTEs    ???
  7183.      1Eh    DWORD    pointer to ???
  7184.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7185.      26h    BYTE    seek type (02h = from end)
  7186.      28h    DWORD    offset on call
  7187.             returned new absolute position
  7188.     ---class 05h functions 0Bh,0Ch---
  7189.      17h  7 BYTEs    ???
  7190.      1Eh    DWORD    pointer to ???
  7191.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7192.      28h    WORD    number of bytes to transfer
  7193.             returned bytes actually transferred
  7194.      2Ah    DWORD    transfer address
  7195.     ---class 05h function 0Dh---
  7196.      17h  7 BYTEs    ???
  7197.      1Eh    DWORD    pointer to ???
  7198.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7199.      26h    BYTE    file handle???
  7200.      27h    BYTE    unused???
  7201.      28h    WORD    ???
  7202.      2Ah    WORD    ???
  7203.      2Ch    WORD    ???
  7204.      2Eh    WORD    ???
  7205.     ---class 05h function 0Eh---
  7206.      17h  7 BYTEs    ???
  7207.      1Eh    DWORD    pointer to ???
  7208.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7209.      26h    BYTE    00h commit file
  7210.             01h close file
  7211.      27h    BYTE    unused???
  7212.     ---class 05h function 0Fh---
  7213.      17h  7 BYTEs    ???
  7214.      1Eh    DWORD    pointer to ???
  7215.      22h  4 BYTEs    ???
  7216.      26h    BYTE    02h GET attributes
  7217.             03h PUT attributes
  7218.      27h    BYTE    unused???
  7219.      28h 12 BYTEs    ???
  7220.      34h    WORD    search attributes???
  7221.      36h    DWORD    pointer to filename
  7222.      3Ah    WORD    (GET) returned ???
  7223.      3Ch    WORD    (GET) returned ???
  7224.      3Eh    WORD    (GET) returned ???
  7225.      40h    WORD    (GET) returned ???
  7226.      42h    WORD    (PUT) new attributes
  7227.             (GET) returned attributes
  7228.     ---class 05h function 10h---
  7229.      17h  7 BYTEs    ???
  7230.      1Eh    DWORD    pointer to ???
  7231.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7232.      26h    WORD    ???
  7233.      28h    DWORD    pointer to ???
  7234.      2Ch    WORD    ???
  7235.      2Eh    BYTE    ???
  7236.      2Fh    BYTE    subfunction
  7237.             01h get printer setup
  7238.             03h ???
  7239.             04h ???
  7240.             05h ???
  7241.             06h ???
  7242.             07h ???
  7243.             21h set printer setup
  7244.     ---class 05h function 11h---
  7245.      17h  7 BYTEs    ???
  7246.      1Eh    DWORD    pointer to ???
  7247.      22h    DWORD    pointer to IFS open file structure (see #0968)
  7248.      26h    BYTE    subfunction
  7249.      27h    BYTE    unused???
  7250.      28h    WORD    ???
  7251.      2Ah    WORD    ???
  7252.      2Ch    WORD    ???
  7253.      2Eh    BYTE    ???
  7254.      2Fh    BYTE    ???
  7255.     ---class 05h function 12h---
  7256.      17h 15 BYTEs    unused???
  7257.      26h    WORD    PSP segment
  7258.      28h    BYTE    type of process termination
  7259.      29h    BYTE    unused???
  7260.     ---class 05h function 13h---
  7261.      17h 15 BYTEs    unused???
  7262.      26h    WORD    PSP segment
  7263. ---request class 06h---
  7264.  16h    DWORD    returned pointer to string corresponding to error code at 03h
  7265.  1Ah    BYTE    returned ???
  7266.  1Bh    BYTE    unused
  7267. ---request class 07h---
  7268.  16h    DWORD    pointer to IFS open file structure (see #0968)
  7269.  1Ah    BYTE    ???
  7270.  1Bh    BYTE    unused???
  7271. SeeAlso: #0966,#0965,#0968
  7272.  
  7273. Format of IFS open file structure:
  7274. Offset    Size    Description    (Table 0968)
  7275.  00h    WORD    ???
  7276.  02h    WORD    device info word
  7277.  04h    WORD    file open mode
  7278.  06h    WORD    ???
  7279.  08h    WORD    file attributes
  7280.  0Ah    WORD    owner's network machine number
  7281.  0Ch    WORD    owner's PSP segment
  7282.  0Eh    DWORD    file size
  7283.  12h    DWORD    current offset in file
  7284.  16h    WORD    file time
  7285.  18h    WORD    file date
  7286.  1Ah 11 BYTEs    filename in FCB format
  7287.  25h    WORD    ???
  7288.  27h    WORD    hash value of SFT address
  7289.         (low word of linear address + segment&F000h)
  7290.  29h  3 WORDs    network info from SFT
  7291.  2Fh    WORD    ???
  7292.  
  7293. Format of one item in DOS 4.0+ list of special program names:
  7294. Offset    Size    Description    (Table 0969)
  7295.  00h    BYTE    length of name (00h = end of list)
  7296.  01h  N BYTEs    name in format name.ext
  7297.  N    2 BYTEs    DOS version to return for program (major,minor)
  7298.         (see AH=30h,INT 2F/AX=122Fh)
  7299. ---DOS 4 only---
  7300.  N+2    BYTE    number of times to return fake version number (FFh = always)
  7301. Note:    if the name of the executable for the program making the DOS "get
  7302.       version" call matches one of the names in this list, DOS returns the
  7303.       specified version rather than the true version number
  7304. --------v-215252-----------------------------
  7305. INT 21 - VIRUS - "516"/"Leapfrog" - INSTALLATION CHECK
  7306.     AX = 5252h
  7307. Return: BX = FFEEh if resident
  7308. SeeAlso: AX=4BFFh"Cascade",AX=58CCh
  7309. --------D-2153-------------------------------
  7310. INT 21 - DOS 2+ internal - TRANSLATE BIOS PARAMETER BLOCK TO DRIVE PARAM BLOCK
  7311.     AH = 53h
  7312.     DS:SI -> BIOS Parameter Block (see #0970)
  7313.     ES:BP -> buffer for Drive Parameter Block (see #0708 at AH=32h)
  7314. Return: ES:BP buffer filled
  7315. Notes:    for DOS 3.0+, the cluster at which to start searching is set to 0000h
  7316.       and the number of free clusters is set to FFFFh (unknown)
  7317.     if the number of sectors per cluster is set to zero, MS-DOS will hang
  7318.       at startup because it computes the internally-used shift count by
  7319.       shifting this value right until the carry flag is set; since this
  7320.       will never happen when the field is zero, MS-DOS hangs
  7321.     not supported by Windows NT 3.1
  7322.  
  7323. Format of BIOS Parameter Block:
  7324. Offset    Size    Description    (Table 0970)
  7325.  00h    WORD    number of bytes per sector
  7326.  02h    BYTE    number of sectors per cluster
  7327.  03h    WORD    number of reserved sectors at start of disk
  7328.  05h    BYTE    number of FATs
  7329.  06h    WORD    number of entries in root directory
  7330.  08h    WORD    total number of sectors
  7331.         for DOS 4.0+, set to zero if partition >32M, then set DWORD at
  7332.           15h to actual number of sectors
  7333.  0Ah    BYTE    media ID byte (see #0669)
  7334.  0Bh    WORD    number of sectors per FAT
  7335. ---DOS 2.13---
  7336.  0Dh    WORD    number of sectors per track
  7337.  0Fh    WORD    number of heads
  7338.  11h    WORD    number of hidden sectors
  7339. ---DOS 3.0+ ---
  7340.  0Dh    WORD    number of sectors per track
  7341.  0Fh    WORD    number of heads
  7342.  11h    DWORD    number of hidden sectors
  7343.  15h 11 BYTEs    reserved
  7344. ---DOS 4.0+ ---
  7345.  15h    DWORD    total number of sectors if word at 08h contains zero
  7346.  19h  6 BYTEs    ???
  7347.  1Fh    WORD    number of cylinders
  7348.  21h    BYTE    device type
  7349.  22h    WORD    device attributes (removable or not, etc)
  7350. ---DR DOS 5+ ---
  7351.  15h    DWORD    total number of sectors if word at 08h contains zero
  7352.  19h  6 BYTEs    reserved
  7353. ---European MS-DOS 4.00---
  7354.  15h    DWORD    total number of sectors if word at 08h contains zero
  7355.         (however, this DOS does not actually implement >32M partitions)
  7356. SeeAlso: #0708
  7357. --------D-2154-------------------------------
  7358. INT 21 - DOS 2+ - GET VERIFY FLAG
  7359.     AH = 54h
  7360. Return: AL = verify flag
  7361.         00h off
  7362.         01h on (all disk writes verified after writing)
  7363. SeeAlso: AH=2Eh
  7364. --------v-2154--BX4475-----------------------
  7365. INT 21 - VIRUS - "Dual_GtM"/"Ganeu" - INSTALLATION CHECK
  7366.     AH = 54h
  7367.     BX = 4475h ("Du")
  7368.     CX = 616Ch ("al")
  7369. Return: BX = 4774h ("Gt") and CX = 4D21h ("M!") if resident
  7370. SeeAlso: AX=50FDh"VIRUS",AX=5454h"VIRUS"
  7371. --------v-215454-----------------------------
  7372. INT 21 - VIRUS - "Dudley" - INSTALLATION CHECK
  7373.     AX = 5454h
  7374. Return: AX = 0000h if resident
  7375. SeeAlso: AX=50FDh"VIRUS",AH=54h/BX=4475h"VIRUS",AX=7BCEh"VIRUS"
  7376. --------D-2155-------------------------------
  7377. INT 21 - DOS 2+ internal - CREATE CHILD PSP
  7378.     AH = 55h
  7379.     DX = segment at which to create new PSP
  7380.     SI = (DOS 3.0+) value to place in memory size field at DX:[0002h]
  7381. Return: AL destroyed
  7382. Notes:    creates a "child" PSP rather than making an exact copy of the current
  7383.       PSP; the new PSP's parent pointer is set to the current PSP and the
  7384.       reference count for each inherited file is incremented
  7385.     (DOS 2.0+) sets current PSP to DX
  7386.     (DOS 3.0+) marks "no inherit" file handles as closed in child PSP
  7387.     this function is implemented using the same code as AH=26h, so unlike
  7388.       other DOS 2+ functions, it does not return status in CF, instead
  7389.       returning status in AL as DOS 1.x functions do (but it never puts an
  7390.       explicit return value in AL)
  7391. SeeAlso: AH=26h,AH=50h
  7392. --------D-2156-------------------------------
  7393. INT 21 - DOS 2+ - "RENAME" - RENAME FILE
  7394.     AH = 56h
  7395.     DS:DX -> ASCIZ filename of existing file (no wildcards, but see below)
  7396.     ES:DI -> ASCIZ new filename (no wildcards)
  7397.     CL = attribute mask (server call only, see below)
  7398. Return: CF clear if successful
  7399.     CF set on error
  7400.         AX = error code (02h,03h,05h,11h) (see #0980)
  7401. Notes:    allows move between directories on same logical volume
  7402.     this function does not set the archive attribute
  7403.       (see #0731 at AX=4301h), which results in incremental backups not
  7404.       backing up the file under its new name
  7405.     open files should not be renamed
  7406.     (DOS 3.0+) allows renaming of directories
  7407.     (DOS 3.1+) wildcards are allowed if invoked via AX=5D00h, in which case
  7408.       error 12h (no more files) is returned on success, and both source and
  7409.       destination specs must be canonical (as returned by AH=60h).
  7410.       Wildcards in the destination are replaced by the corresponding char
  7411.       of each source file being renamed.  Under DOS 3.x, the call will fail
  7412.       if the destination wildcard is *.* or equivalent; under DR DOS 5.0,
  7413.       the call will fail if any wildcards are used.     When invoked via
  7414.       AX=5D00h, only those files matching the attribute mask in CL are
  7415.       renamed.
  7416.     under the FlashTek X-32 DOS extender, the old-name pointer is in DS:EDX
  7417.       and the new-name pointer is in ES:EDI (DS must equal ES)
  7418.     (DOS 2.x only) this function renames file by creating a new directory
  7419.       entry with the new name,then marking the old entry deleted
  7420. BUG:    under DR DOS 3.41, this function will generate a new directory entry
  7421.       with the new name (including any wildcards) which can only be removed
  7422.       with a sector editor when invoked via AX=5D00h
  7423. SeeAlso: AH=17h,AX=4301h,AX=5D00h,AH=60h,AH=71h,AX=F257h/SF=04h
  7424. --------v-215643------------------------
  7425. INT 21 - VIRUS - "PS-MPC.Gold" - INSTALLATION CHECK
  7426.     AX = 5643h  ('VC')
  7427. Return: AX = 5053h  ('PS') if resident
  7428. SeeAlso: AX=33E0h"VIRUS",AX=6303h"VIRUS"
  7429. --------D-215700-----------------------------
  7430. INT 21 - DOS 2+ - GET FILE'S LAST-WRITTEN DATE AND TIME
  7431.     AX = 5700h
  7432.     BX = file handle
  7433. Return: CF clear if successful
  7434.         CX = file's time (see #0971)
  7435.         DX = file's date (see #0972)
  7436.     CF set on error
  7437.         AX = error code (01h,06h) (see #0980)
  7438. Note:    under DR DOS 3.41 and 5.0, this function returns 0 (no date/time) for
  7439.       character devices; MS-DOS returns date and time of opening
  7440. SeeAlso: AX=5701h,AX=5704h"Windows95"
  7441.  
  7442. Bitfields for file time:
  7443. Bit(s)    Description    (Table 0971)
  7444.  15-11    hours (0-23)
  7445.  10-5    minutes
  7446.  4-0    seconds/2
  7447.  
  7448. Bitfields for file date:
  7449. Bit(s)    Description    (Table 0972)
  7450.  15-9    year - 1980
  7451.  8-5    month
  7452.  4-0    day
  7453. --------D-215701-----------------------------
  7454. INT 21 - DOS 2+ - SET FILE'S LAST-WRITTEN DATE AND TIME
  7455.     AX = 5701h
  7456.     BX = file handle
  7457.     CX = new time (see #0971)
  7458.     DX = new date (see #0972)
  7459. Return: CF clear if successful
  7460.     CF set on error
  7461.         AX = error code (01h,06h) (see #0980)
  7462. SeeAlso: AX=5700h,AX=5705h"Windows95",AX=5707h"Windows95"
  7463. --------D-215702-----------------------------
  7464. INT 21 - DOS 4.x only - GET EXTENDED ATTRIBUTES FOR FILE
  7465.     AX = 5702h
  7466.     BX = file handle
  7467.     CX = size of result buffer or 0000h
  7468.     DS:SI -> EAP list (see #0973)
  7469.     ES:DI -> buffer for returned EAV list (see #0976)
  7470. Return: CF clear if successful
  7471.         CX = size of returned data
  7472.     CF set on error
  7473.         AX = error code (see #0980)
  7474. Desc:    get the current value of one or more extended attributes
  7475. Notes:    if CX=0000h on entry, ES:DI is ignored and no data is actually
  7476.       returned, only the amount of data which is available
  7477.     the default DOS 4 behavior is to return a single word of 0000h (no
  7478.       structures) in the result buffer if CX>=0002h on entry; this
  7479.       functionality was apparently never released to the public
  7480. SeeAlso: AX=5703h,AX=5704h,AH=6Eh,INT 2F/AX=112Dh
  7481.  
  7482. Format of EAP (extended attribute properties) list:
  7483. Offset    Size    Description    (Table 0973)
  7484.  00h    WORD    number of EAP structures following
  7485.  02h    var    array of EAP structures (see #0974)
  7486. SeeAlso: #0976
  7487.  
  7488. Format of EAP (extended attribute property) structure:
  7489. Offset    Size    Description    (Table 0974)
  7490.  00h    BYTE    attribute type
  7491.         01h boolean (either 00h or 01h)
  7492.         02h number (BYTE, WORD, or DWORD)
  7493.         03h string
  7494.         04h date stamp
  7495.         05h time stamp
  7496.  01h    WORD    EAP flags (see #0975)
  7497.  03h    BYTE    size of reference string (name)
  7498.  04h  N BYTEs    reference string
  7499.  
  7500. Bitfields for EAP flags:
  7501. Bit(s)    Description    (Table 0975)
  7502.  12    unchangeable
  7503.  13    ignore
  7504.  14    unchangeable
  7505.  15    used by COMMAND.COM for code page, but not understood by ATTRIB
  7506.  
  7507. Format of EAV (extended attribute value) list:
  7508. Offset    Size    Description    (Table 0976)
  7509.  00h    WORD    number of EAV structures following
  7510.  02h    var    array of Extended Attribute Value structures (see #0977)
  7511. SeeAlso: #0973
  7512.  
  7513. Format of Extended Attribute Value structures:
  7514. Offset    Size    Description    (Table 0977)
  7515.  00h  4 BYTEs    ???
  7516.  04h    BYTE    size of reference string
  7517.  05h    WORD    size of value
  7518.  07h    var    reference string
  7519.     var    value
  7520. --------O-215702-----------------------------
  7521. INT 21 - OS/2 v1.1+ Family API - DosQFileInfo
  7522.     AX = 5702h
  7523.     BX = file handle
  7524.     CX = size of buffer for information
  7525.     DX = level of information
  7526.         0001h standard file information (see #3227)
  7527.         0002h Query EA Size (see #3227)
  7528.         0003h Query EAs from List (see #3228)
  7529.         0004h Query All EAs (see #3228)
  7530.     ES:DI -> buffer for information (see #3227,#3228)
  7531. Return: CF clear if successful
  7532.     CF set on error
  7533.         AX = error code
  7534. SeeAlso: AX=5702h/BX=FFFFh,AX=5703h"OS/2",AH=6Dh"OS/2"
  7535.  
  7536. Format of OS/2 DosQFileInfo:
  7537. Offset    Size    Description    (Table 3227)
  7538.  00h    WORD    creation date
  7539.  02h    WORD    creation time
  7540.  04h    WORD    last access date
  7541.  06h    WORD    last access time
  7542.  08h    WORD    last write date
  7543.  0Ah    WORD    last write time
  7544.  0Ch    DWORD    file size in bytes
  7545.  10h    DWORD    allocated space in bytes
  7546.  14h    WORD    file attributes
  7547. ---level 2 only---
  7548.  16h    DWORD    size of Extended Attributes in byte
  7549. SeeAlso: #3228,#3229
  7550.  
  7551. Format of OS/2 DosQFileInfo, EAOP structure:
  7552. Offset    Size    Description    (Table 3228)
  7553.  00h    DWORD    pointer to general EA list (see #3231)
  7554.  04h    DWORD    pointer to buffer for full EA list, with length field set
  7555.  08h    DWORD    (ret) error
  7556. Note:    for info level 3, the first pointer must contain the address of a
  7557.       list of the Extended Attributes to be retrieved; for info level 4,
  7558.       it should be 0000h:0000h
  7559. SeeAlso: #3227,#3229
  7560.  
  7561. Format of OS/2 DosQFileInfo, General EA List:
  7562. Offset    Size    Description    (Table 3231)
  7563.  00h    DWORD    (call) total size of list in bytes (including this field)
  7564.         (ret) number of bytes actually used (including this field)
  7565.  04h    var    Extended Attribute entries (see #3232) [packed arrray]
  7566.  
  7567. Format of OS/2 DosQFileInfo, General EA entry:
  7568. Offset    Size    Description    (Table 3232)
  7569.  00h    BYTE    length of Extended Attribute name (excluding terminating NUL)
  7570.  01h  N BYTEs    EA name
  7571.     BYTE    00h
  7572. SeeAlso: #3231
  7573.  
  7574. Format of OS/2 DosQFileInfo, Full EA List:
  7575. Offset    Size    Description    (Table 3229)
  7576.  00h    DWORD    (call) total size of list in bytes (including this field)
  7577.         (ret) number of bytes actually used (including this field)
  7578.  04h    var    Extended Attribute data (see #3230) [packed array]
  7579. SeeAlso: #3227,#3228
  7580.  
  7581. Format of OS/2 Extended Attribute data (struct FEA):
  7582. Offset    Size    Description    (Table 3230)
  7583.  00h    BYTE    flags
  7584.         bit 7: critical EA
  7585.  01h    BYTE    length of Extended Attribute name (excluding terminating NUL)
  7586.  02h    WORD    length of Extended Attribute value
  7587.  04h  N BYTEs    EA name
  7588.     BYTE    00h
  7589.       M BYTEs    EA value
  7590. --------O-215702BXFFFF-----------------------
  7591. INT 21 - OS/2 v1.1+ Compatibility Box Family API - DosQPathInfo
  7592.     AX = 5702h
  7593.     BX = FFFFh
  7594.     CX = size of buffer for information
  7595.     DX = level of information (0002h)
  7596.     DS:SI -> filename
  7597.     ES:DI -> buffer for FAPI path information (see #0978)
  7598. Return: CF clear if successful
  7599.         AL = 00h
  7600.     CF set on error
  7601.         AX = error code
  7602. SeeAlso: AX=5702h"OS/2",AX=5703h/BX=FFFFh
  7603.  
  7604. Format of FAPI path information:
  7605. Offset    Size    Description    (Table 0978)
  7606.  00h 22 BYTEs    ???
  7607.  16h    DWORD    extended attribute size (none present if less than 5)
  7608. --------D-215703-----------------------------
  7609. INT 21 - DOS 4.x only - GET EXTENDED ATTRIBUTE PROPERTIES
  7610.     AX = 5703h
  7611.     BX = file handle
  7612.     CX = size of result buffer or 0000h
  7613.     ES:DI -> result buffer
  7614. Return: CF clear if successful
  7615.         CX = size of returned data
  7616.     CF set on error
  7617.         AX = error code (see #0980)
  7618.     ES:DI -> zero word (DOS 4.0) if CX >= 2 on entry
  7619. Desc:    get a list of the extended attributes which are defined for the
  7620.       specified file
  7621. Notes:    if CX=0000h on entry, ES:DI is ignored and no data is actually
  7622.       returned, only the amount of data which is available
  7623.     the default DOS 4 behavior is to return a trivial EAP list consisting
  7624.       of the single word 0000h (no EAP structures) if CX>=0002h on entry;
  7625.       this functionality was apparently never released to the public
  7626. SeeAlso: AX=5702h,AX=5704h,AH=6Eh,INT 2F/AX=112Dh
  7627. --------O-215703-----------------------------
  7628. INT 21 - OS/2 v1.1+ Family API - DosSetFileInfo
  7629.     AX = 5703h
  7630.     BX = file handle
  7631.     CX = size of information buffer
  7632.     DX = level of information
  7633.     ES:DI -> information buffer
  7634. Return: CF clear if successful
  7635.     CF set on error
  7636.         AX = error code
  7637. SeeAlso: AX=5702h"OS/2",AX=5703h/BX=FFFFh
  7638. --------O-215703BXFFFF-----------------------
  7639. INT 21 - OS/2 v1.1+ Family API - DosSetPathInfo
  7640.     AX = 5703h
  7641.     BX = FFFFh
  7642.     CX = size of information buffer
  7643.     DX = level of information
  7644.     DS:SI -> filename
  7645.     ES:DI -> information buffer
  7646. Return: CF clear if successful
  7647.     CF set on error
  7648.         AX = error code
  7649. SeeAlso: AX=5702h/BX=FFFFh,AX=5703h"OS/2"
  7650. --------D-215704-----------------------------
  7651. INT 21 - DOS 4.x only - SET EXTENDED ATTRIBUTES
  7652.     AX = 5704h
  7653.     BX = file handle
  7654.     ES:DI -> EAV list (see #0976)
  7655. Return: CF clear if successful
  7656.     CF set on error
  7657.         AX = error code (see #0980)
  7658. Note:    the default DOS 4 behavior is to do nothing and return successfully;
  7659.       this functionality was apparently never released to the public
  7660. SeeAlso: AX=5702h,AX=5703h,INT 2F/AX=112Dh
  7661. --------D-215704-----------------------------
  7662. INT 21 - MS-DOS 7/Windows95 - GET LAST ACCESS DATE AND TIME
  7663.     AX = 5704h
  7664.     BX = file handle
  7665. Return: CF clear if successful
  7666.         DX = last access date (see #0972)
  7667.         CX = last access time (currently always 0000h)
  7668.     CF set on error
  7669.         AX = error code
  7670. SeeAlso: AX=5701h,AX=5705h,AX=5706h
  7671. --------D-215705-----------------------------
  7672. INT 21 - MS-DOS 7/Windows95 - SET LAST ACCESS DATE AND TIME
  7673.     AX = 5705h
  7674.     BX = file handle
  7675.     CX = new last-access time (currently not supported, must be 0000h)
  7676.     DX = new last-access date (see #0972)
  7677. Return: CF clear if successful
  7678.     CF set on error
  7679.         AX = error code
  7680. SeeAlso: AX=5700h,AX=5704h"Windows95",AX=5707h
  7681. --------D-215706-----------------------------
  7682. INT 21 - MS-DOS 7/Windows95 - GET CREATION DATE AND TIME
  7683.     AX = 5706h
  7684.     BX = file handle
  7685. Return: CF clear if successful
  7686.         CX = creation time (see #0971)
  7687.         DX = creation date (see #0972)
  7688.         SI = number of 10-millisecond units past time in CX (0-199)
  7689.     CF set on error
  7690.         AX = error code
  7691. SeeAlso: AX=5701h,AX=5704h"Windows95",AX=5707h
  7692. --------D-215707-----------------------------
  7693. INT 21 - MS-DOS 7/Windows95 - SET CREATION DATE AND TIME
  7694.     AX = 5707h
  7695.     BX = file handle
  7696.     CX = new creation time (see #0971)
  7697.     DX = new creation date (see #0972)
  7698.     SI = new creation time: 10-millisecond units past time in CX (0-199)
  7699. Return: CF clear if successful
  7700.     CF set on error
  7701.         AX = error code
  7702. SeeAlso: AX=5700h,AX=5705h,AX=5706h
  7703. --------U-215757BX5757-----------------------
  7704. INT 21 U - IBM Genie - Resident Manager - INSTALLATION CHECK
  7705.     AX = 5757h
  7706.     BX = 5757h
  7707. Return: AX = 0000h if installed
  7708.         BX = ???
  7709.         DX = ???
  7710.         DS:SI -> list of 27 DWORD entry point addresses
  7711. Program: IBM Genie is a set of utility TSRs by Helix Software
  7712. Note:    other functions possible if BX <> 5757h, but details not yet available
  7713. ----------215758-----------------------------
  7714. INT 21 U - Headroom - API
  7715.     AX = 5758h
  7716.     BL = function
  7717.         00h ???
  7718.         01h get Headroom location
  7719.         Return: CF clear if installed
  7720.                 AX = PSP segment of Headroom TSR
  7721.                 BX = paragraphs of memory used by Headroom
  7722.             CF set if not (normal DOS return)
  7723.         Note:    this function is also used as an installation check
  7724.         02h get INT 21 handler
  7725.         Return: CF clear
  7726.             ES:BX -> Headroom's INT 21 handler
  7727.         Note: also sets unknown flag
  7728.         03h launch application???
  7729.         DS:SI -> 233-byte application record
  7730.         Return: ???
  7731.         04h ???
  7732.         ???
  7733.         Return: CF clear
  7734.         05h get swap directory
  7735.         Return: CF clear
  7736.             DX:AX -> ASCIZ swap directory name
  7737.         06h ???
  7738.         DX = ???
  7739.         Return: CF clear
  7740.         07h ???
  7741.         08h ???
  7742.         09h get current application
  7743.         Return: BX = application number
  7744.         0Ah ???
  7745.         DX = application number
  7746.         DS:SI = ???
  7747.         Return: ???
  7748.         0Bh ???
  7749.         0Ch ???
  7750.         DX = application number
  7751.         ???
  7752.         Return: ???
  7753.         0Dh ???
  7754.         DX = application number
  7755.         ???
  7756.         Return: ???
  7757.         0Eh get ???
  7758.         Return: CF clear
  7759.             AX = ???
  7760.         0Fh set ??? flag
  7761.         10h clear ??? flag
  7762.         11h find application by name
  7763.         DS:SI -> ASCIZ application name
  7764.         Return: CF clear
  7765.             AX = application number or FFFFh if not loaded
  7766.         12h ???
  7767.         DX = application number
  7768.         Return: CF clear
  7769.             ???
  7770.         13h ???
  7771.         Return: CF clear
  7772.         14h ???
  7773.         same as function 13h
  7774.         15h set ???
  7775.         DX = ???
  7776.         16h get ???
  7777.         Return: AX = ??? set by function 15h
  7778.         17h get ???
  7779.         Return: BX = ???
  7780.             CX = ??? (may be pointer in BX:CX)
  7781.         18h BUG: branches incorrectly due to fencepost error
  7782. Program: Headroom is a TSR/task switcher by Helix Software
  7783. SeeAlso: AX=4C57h,AX=5757h,INT 2F/AX=5758h
  7784. --------D-2158-------------------------------
  7785. INT 21 - DOS 2.11+ - GET OR SET MEMORY ALLOCATION STRATEGY
  7786.     AH = 58h
  7787.     AL = subfunction
  7788.         00h get allocation strategy
  7789.         Return: AX = current strategy (see #0979)
  7790.         01h set allocation strategy
  7791.         BL = new allocation strategy (see #0979)
  7792.         BH = 00h (DOS 5+)
  7793. Return: CF clear if successful
  7794.     CF set on error
  7795.         AX = error code (01h) (see #0980)
  7796. Notes:    the Set subfunction accepts any value in BL for DOS 3.x and 4.x;
  7797.       2 or greater means last fit
  7798.     the Get subfunction returns the last value set
  7799.     setting an allocation strategy involving high memory does not
  7800.       automatically link in the UMB memory chain; this must be done
  7801.       explicitly with AX=5803h in order to actually allocate high memory
  7802.     a program which changes the allocation strategy should restore it
  7803.       before terminating
  7804.     Toshiba MS-DOS v2.11 supports subfunctions 00h and 01h, as does the
  7805.       TI Professional MS-DOS v2.13
  7806.     DR DOS 3.41 reportedly reverses subfunctions 00h and 01h
  7807. SeeAlso: AH=48h,AH=49h,AH=4Ah,INT 2F/AX=4310h,INT 67/AH=3Fh
  7808.  
  7809. (Table 0979)
  7810. Values for DOS memory allocation strategy:
  7811.  00h low memory first fit
  7812.  01h low memory best fit
  7813.  02h low memory last fit
  7814. ---DOS 5+ ---
  7815.  40h high memory first fit
  7816.  41h high memory best fit
  7817.  42h high memory last fit
  7818.  80h first fit, try high then low memory
  7819.  81h best fit, try high then low memory
  7820.  82h last fit, try high then low memory
  7821. --------D-2158-------------------------------
  7822. INT 21 - DOS 5+ - GET OR SET UMB LINK STATE
  7823.     AH = 58h
  7824.     AL = subfunction
  7825.         02h get UMB link state
  7826.         Return: AL = current link state
  7827.                 00h UMBs not part of DOS memory chain
  7828.                 01h UMBs in DOS memory chain
  7829.         03h set UMB link state
  7830.         BX = new link state
  7831.             0000h remove UMBs from DOS memory chain
  7832.             0001h add UMBs to DOS memory chain
  7833. Return: CF clear if successful
  7834.     CF set on error
  7835.         AX = error code (01h) (see #0980)
  7836. Notes:    a program which changes the UMB link state should restore it before
  7837.       terminating
  7838.     UMBs will only be available if CONFIG.SYS contains the line DOS=UMB,
  7839.       the UMBs have been linked into the memory chain with AX=5803h, and
  7840.       the allocation strategy has been set to include high memory with
  7841.       AX=5801h
  7842. SeeAlso: #0987,#1995 at INT 2F/AX=4310h
  7843. --------v-2158CC-----------------------------
  7844. INT 21 - VIRUS - "1067"/"Headcrash" - INSTALLATION CHECK
  7845.     AX = 58CCh
  7846. Return: CF clear if resident
  7847. SeeAlso: AX=5643h,AX=5252h,AX=58DDh,AX=6303h"VIRUS",AX=6969h
  7848. --------v-2158DD-----------------------------
  7849. INT 21 - VIRUS - "1067"/"Headcrash" - GET ORIGINAL INT 21h VECTOR
  7850.     AX = 58DDh
  7851. Return: CX = code segment of virus
  7852.     ES:BX = old INT 21h vector
  7853. SeeAlso: AX=5252h,AX=58CCh,AX=6969h
  7854. --------D-2159--BX0000-----------------------
  7855. INT 21 - DOS 3.0+ - GET EXTENDED ERROR INFORMATION
  7856.     AH = 59h
  7857.     BX = 0000h
  7858. Return: AX = extended error code (see #0980)
  7859.     BH = error class (see #0982)
  7860.     BL = recommended action (see #0983)
  7861.     CH = error locus (see #0984)
  7862.     ES:DI may be pointer (see #0981, error code list below)
  7863.     CL, DX, SI, BP, and DS destroyed
  7864. Notes:    functions available under DOS 2.x map the true DOS 3.0+ error code into
  7865.       one supported under DOS 2.x
  7866.     you should call this function to retrieve the true error code when an
  7867.       FCB or DOS 2.x call returns an error
  7868.     under DR DOS 5.0, this function does not use any of the DOS-internal
  7869.       stacks and may thus be called at any time
  7870. SeeAlso: AH=59h/BX=0001h,AX=5D0Ah,INT 2F/AX=122Dh
  7871.  
  7872. (Table 0980)
  7873. Values for DOS extended error code:
  7874.  00h (0)   no error
  7875.  01h (1)   function number invalid
  7876.  02h (2)   file not found
  7877.  03h (3)   path not found
  7878.  04h (4)   too many open files (no handles available)
  7879.  05h (5)   access denied
  7880.  06h (6)   invalid handle
  7881.  07h (7)   memory control block destroyed
  7882.  08h (8)   insufficient memory
  7883.  09h (9)   memory block address invalid
  7884.  0Ah (10)  environment invalid (usually >32K in length)
  7885.  0Bh (11)  format invalid
  7886.  0Ch (12)  access code invalid
  7887.  0Dh (13)  data invalid
  7888.  0Eh (14)  reserved
  7889.  0Fh (15)  invalid drive
  7890.  10h (16)  attempted to remove current directory
  7891.  11h (17)  not same device
  7892.  12h (18)  no more files
  7893. ---DOS 3.0+ ---
  7894.  13h (19)  disk write-protected
  7895.  14h (20)  unknown unit
  7896.  15h (21)  drive not ready
  7897.  16h (22)  unknown command
  7898.  17h (23)  data error (CRC)
  7899.  18h (24)  bad request structure length
  7900.  19h (25)  seek error
  7901.  1Ah (26)  unknown media type (non-DOS disk)
  7902.  1Bh (27)  sector not found
  7903.  1Ch (28)  printer out of paper
  7904.  1Dh (29)  write fault
  7905.  1Eh (30)  read fault
  7906.  1Fh (31)  general failure
  7907.  20h (32)  sharing violation
  7908.  21h (33)  lock violation
  7909.  22h (34)  disk change invalid (ES:DI -> media ID structure)(see #0981)
  7910.  23h (35)  FCB unavailable
  7911.  24h (36)  sharing buffer overflow
  7912.  25h (37)  (DOS 4.0+) code page mismatch
  7913.  26h (38)  (DOS 4.0+) cannot complete file operation (out of input)
  7914.  27h (39)  (DOS 4.0+) insufficient disk space
  7915.  28h-31h   reserved
  7916.  32h (50)  network request not supported
  7917.  33h (51)  remote computer not listening
  7918.  34h (52)  duplicate name on network
  7919.  35h (53)  network name not found
  7920.  36h (54)  network busy
  7921.  37h (55)  network device no longer exists
  7922.  38h (56)  network BIOS command limit exceeded
  7923.  39h (57)  network adapter hardware error
  7924.  3Ah (58)  incorrect response from network
  7925.  3Bh (59)  unexpected network error
  7926.  3Ch (60)  incompatible remote adapter
  7927.  3Dh (61)  print queue full
  7928.  3Eh (62)  queue not full
  7929.  3Fh (63)  not enough space to print file
  7930.  40h (64)  network name was deleted
  7931.  41h (65)  network: Access denied
  7932.  42h (66)  network device type incorrect
  7933.  43h (67)  network name not found
  7934.  44h (68)  network name limit exceeded
  7935.  45h (69)  network BIOS session limit exceeded
  7936.  46h (70)  temporarily paused
  7937.  47h (71)  network request not accepted
  7938.  48h (72)  network print/disk redirection paused
  7939.  49h (73)  network software not installed
  7940.         (LANtastic) invalid network version
  7941.  4Ah (74)  unexpected adapter close
  7942.         (LANtastic) account expired
  7943.  4Bh (75)  (LANtastic) password expired
  7944.  4Ch (76)  (LANtastic) login attempt invalid at this time
  7945.  4Dh (77)  (LANtastic v3+) disk limit exceeded on network node
  7946.  4Eh (78)  (LANtastic v3+) not logged in to network node
  7947.  4Fh (79)  reserved
  7948.  50h (80)  file exists
  7949.  51h (81)  reserved
  7950.  52h (82)  cannot make directory
  7951.  53h (83)  fail on INT 24h
  7952.  54h (84)  (DOS 3.3+) too many redirections
  7953.  55h (85)  (DOS 3.3+) duplicate redirection
  7954.  56h (86)  (DOS 3.3+) invalid password
  7955.  57h (87)  (DOS 3.3+) invalid parameter
  7956.  58h (88)  (DOS 3.3+) network write fault
  7957.  59h (89)  (DOS 4.0+) function not supported on network
  7958.  5Ah (90)  (DOS 4.0+) required system component not installed
  7959.  64h (100) (MSCDEX) unknown error
  7960.  65h (101) (MSCDEX) not ready
  7961.  66h (102) (MSCDEX) EMS memory no longer valid
  7962.  67h (103) (MSCDEX) not High Sierra or ISO-9660 format
  7963.  68h (104) (MSCDEX) door open
  7964.  B0h (176) (MS-DOS 7.0) volume is not locked
  7965.  B1h (177) (MS-DOS 7.0) volume is locked in drive
  7966.  B2h (178) (MS-DOS 7.0) volume is not removable
  7967.  B4h (180) (MS-DOS 7.0) lock count has been exceeded
  7968.  B5h (181) (MS-DOS 7.0) a valid eject request failed
  7969. SeeAlso: #0982,#0983,#0984
  7970.  
  7971. Format of media ID structure:
  7972. Offset    Size    Description    (Table 0981)
  7973.  00h 12 BYTEs    ASCIZ volume label of required disk
  7974.  0Ch    DWORD    serial number (DOS 4.0+)
  7975.  
  7976. (Table 0982)
  7977. Values for DOS Error Class:
  7978.  01h    out of resource (storage space or I/O channels)
  7979.  02h    temporary situation (file or record lock)
  7980.  03h    authorization (denied access)
  7981.  04h    internal (system software bug)
  7982.  05h    hardware failure
  7983.  06h    system failure (configuration file missing or incorrect)
  7984.  07h    application program error
  7985.  08h    not found
  7986.  09h    bad format
  7987.  0Ah    locked
  7988.  0Bh    media error
  7989.  0Ch    already exists
  7990.  0Dh    unknown
  7991. SeeAlso: #0980,#0983,#0984
  7992.  
  7993. (Table 0983)
  7994. Values for DOS Suggested Action:
  7995.  01h    retry
  7996.  02h    delayed retry
  7997.  03h    prompt user to reenter input
  7998.  04h    abort after cleanup
  7999.  05h    immediate abort
  8000.  06h    ignore
  8001.  07h    retry after user intervention
  8002. SeeAlso: #0980,#0982,#0984
  8003.  
  8004. (Table 0984)
  8005. Values for DOS Error Locus:
  8006.  01h    unknown or not appropriate
  8007.  02h    block device (disk error)
  8008.  03h    network related
  8009.  04h    serial device (timeout)
  8010.  05h    memory related
  8011. SeeAlso: #0980,#0982,#0983
  8012. --------D-2159--BX0001-----------------------
  8013. INT 21 - European MS-DOS 4.0 - GET HARD ERROR INFORMATION
  8014.     AH = 59h
  8015.     BX = 0001h
  8016. Return: ES:DI -> hard error information packet (see #0985) for most recent
  8017.         hard (critical) error
  8018. SeeAlso: AH=59h/BX=0000h,AH=95h,INT 24
  8019.  
  8020. Format of European MS-DOS 4.0 hard error information packet:
  8021. Offset    Size    Description    (Table 0985)
  8022.  00h    WORD    contents of AX at system entry
  8023.  02h    WORD    Process ID which encountered error
  8024.  04h    WORD    contents of AX at time of error
  8025.  06h    BYTE    error type
  8026.         00h physical I/O error
  8027.         01h disk change request
  8028.         02h file sharing violation
  8029.         03h FCB problem
  8030.         04h file locking violation
  8031.         05h bad FAT
  8032.         06h network detected error
  8033.  07h    BYTE    INT 24 error code
  8034.  08h    WORD    extended error code (see #0980)
  8035.  0Ah    DWORD    pointer to associated device
  8036. --------D-215A-------------------------------
  8037. INT 21 - DOS 3.0+ - CREATE TEMPORARY FILE
  8038.     AH = 5Ah
  8039.     CX = file attribute (see #0731 at AX=4301h)
  8040.     DS:DX -> ASCIZ path ending with a '\' + 13 zero bytes to receive the
  8041.         generated filename
  8042. Return: CF clear if successful
  8043.         AX = file handle opened for read/write in compatibility mode
  8044.         DS:DX pathname extended with generated name for temporary file
  8045.     CF set on error
  8046.         AX = error code (03h,04h,05h) (see #0980)
  8047. Desc:    creates a file with a unique name which must be explicitly deleted
  8048. BUGS:    COMPAQ DOS 3.31 hangs if the pathname is at XXXXh:0000h; it apparently
  8049.       wraps around to the end of the segment
  8050.     MS-DOS 5.00 revisions A and B and PC-DOS 5.00 revision A reportedly
  8051.       hang the system if the specified path is the root directory and the
  8052.       root directory is full (no free directory entries)
  8053.     Mark Incley <mincley@krisalis.demon.co.uk> reports that this function
  8054.       hangs in DOS 6.2x if the name includes two consecutive path
  8055.       separators (e.g. C:\\ )
  8056. Notes:    under the FlashTek X-32 DOS extender, the path pointer is in DS:EDX
  8057.     MS-DOS 3.0-4.0 and DR-DOS 3.4-5.0 generate the filename as a sequence
  8058.       of hex digits based on the current date and time; MS-DOS 6+,
  8059.       DR-DOS 6, and Novell DOS 7 use letters A-P in place of hex digits
  8060. SeeAlso: AH=3Ch,AH=5Bh
  8061. --------D-215B-------------------------------
  8062. INT 21 - DOS 3.0+ - CREATE NEW FILE
  8063.     AH = 5Bh
  8064.     CX = file attribute (see #0731 at AX=4301h)
  8065.     DS:DX -> ASCIZ filename
  8066. Return: CF clear if successful
  8067.         AX = file handle opened for read/write in compatibility mode
  8068.     CF set on error
  8069.         AX = error code (03h,04h,05h,50h) (see #0980)
  8070. Notes:    unlike AH=3Ch, this function will fail if the specified file exists
  8071.       rather than truncating it; this permits its use in creating semaphore
  8072.       files because it is an atomic "test and set" operation
  8073.     under the FlashTek X-32 DOS extender, the filename pointer is in DS:EDX
  8074. SeeAlso: AH=3Ch,AH=5Ah
  8075. --------D-215C-------------------------------
  8076. INT 21 - DOS 3.0+ - "FLOCK" - RECORD LOCKING
  8077.     AH = 5Ch
  8078.     AL = subfunction
  8079.         00h lock region of file
  8080.         01h unlock region of file
  8081.     BX = file handle
  8082.     CX:DX = start offset of region within file
  8083.     SI:DI = length of region in bytes
  8084. Return: CF clear if successful
  8085.     CF set on error
  8086.         AX = error code (01h,06h,21h,24h) (see #0980)
  8087. Notes:    error returned unless SHARE or network installed
  8088.     an unlock call must specify the same region as some prior lock call
  8089.     locked regions become entirely inaccessible to other processes
  8090.     duplicate handles created with AH=45h or AH=46h inherit locks, but
  8091.       handles inherited by child processes (see AH=4Bh) do not
  8092.     under DR DOS 3.41 and 5.0, if a process opens a file without the no-
  8093.       inherit flag and then starts a child, any locks set by the parent
  8094.       are ignored, and the child will only get an error if it tries to
  8095.       lock an area previously locked by the parent process
  8096. SeeAlso: AX=440Bh,AH=BCh,AH=BEh,INT 2F/AX=110Ah,INT 2F/AX=110Bh
  8097. --------D-215D00-----------------------------
  8098. INT 21 U - DOS 3.1+ internal - SERVER FUNCTION CALL
  8099.     AX = 5D00h
  8100.     DS:DX -> DOS parameter list (see #0986)
  8101.     DPL contains all register values for a call to INT 21h
  8102. Return: as appropriate for function being called
  8103. Notes:    does not check AH.  Out of range values will crash the system
  8104.     executes using specified computer ID and process ID
  8105.     sharing delay loops skipped
  8106.     a special sharing mode is enabled to handle FCBs opened across network
  8107.     wildcards are enabled for DELETE (AH=41h) and RENAME (AH=56h) under
  8108.       MS-DOS; under DR DOS 3.41, wildcards corrupt the filesystem; and
  8109.       under DR DOS 5.0-6.0, the call returns error code 03h due to improper
  8110.       support for the server function call (see below)
  8111.     an extra file attribute parameter is enabled for OPEN (AH=3Dh),
  8112.       DELETE (AH=41h), and RENAME (AH=56h)
  8113.     functions which take filenames require canonical names (as returned
  8114.       by AH=60h); this is apparently to prevent multi-hop file forwarding
  8115. BUGS:    the OS/2 2.0 DOS Boot Session incorrectly maps DOS drive letters,
  8116.       seemingly ignoring HPFS drives
  8117.     DR DOS 5.0-6.0 merely recursively call INT 21 after loading the
  8118.       registers from the DPL, leading to problems for peer-to-peer
  8119.       networks
  8120. SeeAlso: AH=3Dh,AH=41h,AH=56h,AH=60h
  8121.  
  8122. Format of DOS parameter list:
  8123. Offset    Size    Description    (Table 0986)
  8124.  00h    WORD    AX
  8125.  02h    WORD    BX
  8126.  04h    WORD    CX
  8127.  06h    WORD    DX
  8128.  08h    WORD    SI
  8129.  0Ah    WORD    DI
  8130.  0Ch    WORD    DS
  8131.  0Eh    WORD    ES
  8132.  10h    WORD    reserved (0)
  8133.  12h    WORD    computer ID (0 = current system)
  8134.  14h    WORD    process ID (PSP segment on specified computer)
  8135. Note:    under Windows Enhanced mode, the computer ID is normally the virtual
  8136.       machine ID (see INT 2F/AX=1683h), though this can reportedly be
  8137.       changed by setting UniqueDOSPSP= in SYSTEM.INI
  8138. --------D-215D01-----------------------------
  8139. INT 21 U - DOS 3.1+ internal - COMMIT ALL FILES FOR SPECIFIED COMPUTER/PROCESS
  8140.     AX = 5D01h
  8141.     DS:DX -> DOS parameter list (see #0986), only computer ID and
  8142.           process ID fields used
  8143. Return: CF set on error
  8144.         AX = error code (see #0980)
  8145.     CF clear if successful
  8146. Notes:    flushes buffers and updates directory entries for each file which has
  8147.       been written to; if remote file, calls INT 2F/AX=1107h
  8148.     the computer ID and process ID are stored but ignored under DOS 3.3
  8149.     not supported by DR DOS 3.41 and 5.0; returns error code 01h
  8150. SeeAlso: AH=0Dh,AH=68h,INT 2F/AX=1107h
  8151. --------D-215D02-----------------------------
  8152. INT 21 U - DOS 3.1+ internal - SHARE.EXE - CLOSE FILE BY NAME
  8153.     AX = 5D02h
  8154.     DS:DX -> DOS parameter list (see #0986), only fields DX, DS,
  8155.           computer ID, and process ID used
  8156.     DPL's DS:DX -> ASCIZ name of file to close
  8157. Return: CF set on error
  8158.         AX = error code (see #0980)
  8159.     CF clear if successful
  8160. Notes:    error unless SHARE is loaded (calls [SysFileTable-28h])
  8161.       (see #0943 at AH=52h)
  8162.     name must be canonical fully-qualified, such as returned by AH=60h
  8163.     not supported by DR DOS 3.41 and 5.0; returns error code 01h
  8164.     not supported by Novell DOS 7
  8165. SeeAlso: AX=5D03h,AX=5D04h,AH=3Eh,AH=60h
  8166. --------D-215D03-----------------------------
  8167. INT 21 U - DOS 3.1+ internal - SHARE.EXE - CLOSE ALL FILES FOR GIVEN COMPUTER
  8168.     AX = 5D03h
  8169.     DS:DX -> DOS parameter list (see #0986), only computer ID used
  8170. Return: CF set on error
  8171.         AX = error code (see #0980)
  8172.     CF clear if successful
  8173. Notes:    error unless SHARE is loaded (calls [SysFileTable-30h])
  8174.       (see #0943 at AH=52h)
  8175.     not supported by DR DOS 3.41 and 5.0; returns error code 01h
  8176.     not supported by Novell DOS 7
  8177. SeeAlso: AX=5D02h,AX=5D04h
  8178. --------D-215D04-----------------------------
  8179. INT 21 U - DOS 3.1+ internal - SHARE.EXE - CLOSE ALL FILES FOR GIVEN PROCESS
  8180.     AX = 5D04h
  8181.     DS:DX -> DOS parameter list (see #0986), only computer ID and
  8182.           process ID fields used
  8183. Return: CF set on error
  8184.         AX = error code (see #0980)
  8185.     CF clear if successful
  8186. Notes:    error unless SHARE is loaded (calls [SysFileTable-2Ch])
  8187.        (see #0943 at AH=52h)
  8188.     not supported by DR DOS 3.41 and 5.0; returns error code 01h
  8189.     not supported by Novell DOS 7
  8190. SeeAlso: AX=5D02h,AX=5D03h,INT 2F/AX=111Dh
  8191. --------D-215D05-----------------------------
  8192. INT 21 U - DOS 3.1+ internal - SHARE.EXE - GET OPEN FILE LIST ENTRY
  8193.     AX = 5D05h
  8194.     DS:DX -> DOS parameter list (see #0986)
  8195.     DPL's BX = index of sharing record (see #0944 at AH=52h)
  8196.     DPL's CX = index of SFT in sharing record's SFT list
  8197. Return: CF clear if successful
  8198.         ES:DI -> ASCIZ filename
  8199.         BX = network machine number of SFT's owner
  8200.         CX = number of locks held by SFT's owner
  8201.     CF set if either index out of range
  8202.         AX = 0012h (no more files)
  8203. Notes:    error unless SHARE is loaded (calls [SysFileTable-18h])
  8204.       (see #0943 at AH=52h)
  8205.     names are always canonical fully-qualified, such as returned by AH=60h
  8206.     not supported by DR DOS 3.41 and 5.0 and Novell DOS 7, but does not
  8207.       return an error, instead destroying AX
  8208. SeeAlso: AH=5Ch,AH=60h
  8209. --------D-215D06-----------------------------
  8210. INT 21 U - DOS 3.0+ internal - GET ADDRESS OF DOS SWAPPABLE DATA AREA
  8211.     AX = 5D06h
  8212. Return: CF set on error
  8213.        AX = error code (see #0980)
  8214.     CF clear if successful
  8215.         DS:SI -> nonreentrant data area (includes all three DOS stacks)
  8216.         (critical error flag is first byte) (see #0987)
  8217.         CX = size in bytes of area which must be swapped while in DOS
  8218.         DX = size in bytes of area which must always be swapped
  8219. Notes:    the Critical Error flag is used in conjunction with the InDOS flag
  8220.       (see AH=34h) to determine when it is safe to enter DOS from a TSR
  8221.     setting CritErr flag allows use of functions 50h/51h from INT 28h under
  8222.       DOS 2.x by forcing use of correct stack
  8223.     swapping the data area allows reentering DOS unless DOS is in a
  8224.       critical section delimited by INT 2A/AH=80h and INT 2A/AH=81h,82h
  8225.     under DOS 4.0, AX=5D0Bh should be used instead of this function
  8226.     SHARE and other DOS utilities consult the byte at offset 04h in the
  8227.       DOS data segment (see INT 2F/AX=1203h) to determine the SDA format
  8228.       in use: 00h = DOS 3.x, 01h = DOS 4.0-6.0, other = error.
  8229.     DR DOS 3.41+ supports this function, but the SDA format beyond the
  8230.       first 18h bytes is completely different from MS-DOS
  8231. SeeAlso: AX=5D0Bh,INT 2A/AH=80h,INT 2A/AH=81h,INT 2A/AH=82h
  8232.  
  8233. Format of DOS 3.10-3.30 Swappable Data Area:
  8234. Offset    Size    Description    (Table 0987)
  8235.  -34    BYTE    (DOS 3.10+) printer echo flag (00h off, FFh active)
  8236.  -31    BYTE    (DOS 3.30) current switch character
  8237.  -30    BYTE    current memory allocation strategy (see AH=58h)
  8238.  -28    BYTE    (DOS 3.30) incremented on each INT 21/AX=5E01h call
  8239.  -27 16 BYTEs    (DOS 3.30) machine name set by INT 21/AX=5E01h
  8240.  -11  5 WORDs    zero-terminated list of offsets which need to be patched to
  8241.           enable critical-section calls (see INT 2A/AH=80h)
  8242.  -1    BYTE    unused padding
  8243. ---start of actual SDA---
  8244.  00h    BYTE    critical error flag ("ErrorMode")
  8245.  01h    BYTE    InDOS flag (count of active INT 21 calls)
  8246.  02h    BYTE    drive on which current critical error occurred, or FFh
  8247.         (DR DOS sets to drive number during INT 24, 00h otherwise)
  8248.  03h    BYTE    locus of last error
  8249.  04h    WORD    extended error code of last error
  8250.  06h    BYTE    suggested action for last error
  8251.  07h    BYTE    class of last error
  8252.  08h    DWORD    ES:DI pointer for last error
  8253.  0Ch    DWORD    current DTA (Disk Transfer Address)
  8254.         note: may point into SDA during the DOS EXEC function
  8255.           (see AH=4Bh), so programs which swap the SDA must be
  8256.           prepared to move the DTA to a private buffer if they
  8257.           might be invoked during an EXEC
  8258.  10h    WORD    current PSP
  8259.  12h    WORD    stores SP across an INT 23
  8260.  14h    WORD    return code from last process termination (zerod after reading
  8261.           with AH=4Dh)
  8262.  16h    BYTE    current drive
  8263.  17h    BYTE    extended break flag
  8264. ---remainder need only be swapped if in DOS---
  8265.  18h    WORD    value of AX on call to INT 21
  8266.  1Ah    WORD    PSP segment for sharing/network
  8267.  1Ch    WORD    network machine number for sharing/network (0000h = us)
  8268.  1Eh    WORD    first usable memory block found when allocating memory
  8269.  20h    WORD    best usable memory block found when allocating memory
  8270.  22h    WORD    last usable memory block found when allocating memory
  8271.  24h    WORD    memory size in paragraphs (used only during initialization)
  8272.  26h    WORD    last entry checked during directory search
  8273.  28h    BYTE    flag: INT 24 returned Fail
  8274.  29h    BYTE    flags: allowable INT 24 actions (passed to INT 24 in AH)
  8275.  2Ah    BYTE    directory flag (00h directory, 01h file)
  8276.  2Bh    BYTE    flag: FFh if Ctrl-Break termination, 00h otherwise
  8277.  2Ch    BYTE    flag: allow embedded blanks in FCB
  8278.  2Dh    BYTE    padding (unused)
  8279.  2Eh    BYTE    day of month
  8280.  2Fh    BYTE    month
  8281.  30h    WORD    year - 1980
  8282.  32h    WORD    number of days since 1-1-1980
  8283.  34h    BYTE    day of week (0 = Sunday)
  8284.  35h    BYTE    flag: console swapped during read from device
  8285.  36h    BYTE    flag: safe to call INT 28 if nonzero
  8286.  37h    BYTE    flag: if nonzero, INT 24 Abort turned into INT 24 Fail
  8287.         (set only during process termination)
  8288.  38h 26 BYTEs    device driver request header (see #1884 at INT 2F/AX=0802h)
  8289.  52h    DWORD    pointer to device driver entry point (used in calling driver)
  8290.  56h 22 BYTEs    device driver request header for I/O calls
  8291.  6Ch 14 BYTEs    device driver request header for disk status check
  8292.  7Ah    DWORD    pointer to device I/O buffer???
  8293.  7Eh    WORD    ???
  8294.  80h    WORD    ???
  8295.  82h    BYTE    type of PSP copy (00h=simple for INT 21/AH=26h, FFh=make child)
  8296.  83h    BYTE    padding (unused)
  8297.  84h  3 BYTEs    24-bit user number (see AH=30h)
  8298.  87h    BYTE    OEM number (see #0707 at AH=30h)
  8299.  88h    WORD    offset to error code conversion table for INT 25/INT 26
  8300.  8Ah  6 BYTEs    CLOCK$ transfer record (see #0988)
  8301.  90h    BYTE    device I/O buffer for single-byte I/O functions
  8302.  91h    BYTE    padding??? (unused)
  8303.  92h 128 BYTEs    buffer for filename
  8304. 112h 128 BYTEs    buffer for filename
  8305. 192h 21 BYTEs    findfirst/findnext search data block (see #0933 at AH=4Eh)
  8306. 1A7h 32 BYTEs    directory entry for found file (see #0668 at AH=11h)
  8307. 1C7h 81 BYTEs    copy of current directory structure for drive being accessed
  8308. 218h 11 BYTEs    FCB-format filename for device name comparison
  8309. 223h    BYTE    terminating NUL for above filename
  8310. 224h 11 BYTEs    wildcard destination specification for rename (FCB format)
  8311. 22Fh    BYTE    terminating NUL for above spec
  8312. 230h    BYTE    ???
  8313. 231h    WORD    destination file/directory starting sector
  8314. 233h  5 BYTEs    ???
  8315. 238h    BYTE    extended FCB file attribute
  8316. 239h    BYTE    type of FCB (00h regular, FFh extended)
  8317. 23Ah    BYTE    directory search attributes
  8318. 23Bh    BYTE    file open/access mode
  8319. 23Ch    BYTE    file found/delete flag
  8320.         bit 0: file found
  8321.         bit 4: file deleted
  8322. 23Dh    BYTE    flag: device name found on rename, or file not found
  8323. 23Eh    BYTE    splice flag (file name and directory name together)
  8324. 23Fh    BYTE    flag indicating how DOS function was invoked
  8325.         (00h = direct INT 20/INT 21, FFh = server call AX=5D00h)
  8326. 240h    BYTE    sector position within cluster
  8327. 241h    BYTE    flag: translate sector/cluster (00h no, 01h yes)
  8328. 242h    BYTE    flag: 00h if read, 01h if write
  8329. 243h    BYTE    current working drive number
  8330. 244h    BYTE    cluster factor
  8331. 245h    BYTE    flag: cluster split mode
  8332. 246h    BYTE    line edit (AH=0Ah) insert mode flag (nonzero = on)
  8333. 247h    BYTE    canonicalized filename referred to existing file/dir if FFh
  8334. 248h    BYTE    volume ID flag
  8335. 249h    BYTE    type of process termination (00h-03h) (see AH=4Dh)
  8336. 24Ah    BYTE    file create flag (00h = no, search only)
  8337. 24Bh    BYTE    value with which to replace first byte of deleted file's name
  8338.           (normally E5h, but 00h as described under INT 21/AH=13h)
  8339. 24Ch    DWORD    pointer to Drive Parameter Block for critical error invocation
  8340.         temp: used during process termination
  8341. 250h    DWORD    pointer to stack frame containing user registers on INT 21
  8342. 254h    WORD    stores SP across INT 24
  8343. 256h    DWORD    pointer to DOS Drive Parameter Block for ???
  8344. 25Ah    WORD    saving partial cluster number
  8345. 25Ch    WORD    temp: sector of work current cluster
  8346. 25Eh    WORD    high part of cluster number (only low byte referenced)
  8347. 260h    WORD    ??? temp
  8348. 262h    BYTE    Media ID byte returned by AH=1Bh,1Ch
  8349. 263h    BYTE    padding (unused)
  8350. 264h    DWORD    pointer to device header when filename is character device
  8351. 268h    DWORD    pointer to current SFT
  8352. 26Ch    DWORD    pointer to current directory structure for drive being accessed
  8353. 270h    DWORD    pointer to caller's FCB
  8354. 274h    WORD    number of SFT to which file being opened will refer
  8355. 276h    WORD    temporary storage for file handle
  8356. 278h    DWORD    pointer to a JFT entry in process handle table
  8357.           (see #0691 at AH=26h)
  8358. 27Ch    WORD    offset in DOS DS of first filename argument
  8359. 27Eh    WORD    offset in DOS DS of second filename argument
  8360. 280h    WORD    offset of last component in pathname or FFFFh
  8361. 282h    WORD    offset of transfer address to add
  8362. 284h    WORD    last relative cluster within file being accessed
  8363. 286h    WORD    temp: absolute cluster number being accessed
  8364. 288h    WORD    directory sector number
  8365. 28Ah    WORD    ??? current cluster number
  8366. 28Ch    WORD    current relative sector number within file
  8367. 28Eh    WORD    current sector number
  8368. 290h    WORD    current byte offset within sector
  8369. 292h    DWORD    current offset in file
  8370. 296h    DWORD    temp: file byte count
  8371. 29Ah    WORD    temp: file byte count
  8372. 29Ch    WORD    free file cluster entry
  8373. 29Eh    WORD    last file cluster entry
  8374. 2A0h    WORD    next file cluster number
  8375. 2A2h    DWORD    number of bytes appended to file
  8376. 2A6h    DWORD    pointer to current work disk buffer
  8377. 2AAh    DWORD    pointer to working SFT
  8378. 2AEh    WORD    used by INT 21 dispatcher to store caller's BX
  8379. 2B0h    WORD    used by INT 21 dispatcher to store caller's DS
  8380. 2B2h    WORD    temporary storage while saving/restoring caller's registers
  8381. 2B4h    DWORD    pointer to prev call frame (offset 250h) if INT 21 reentered
  8382.         also switched to for duration of INT 24
  8383. 2B8h 21 BYTEs    FindFirst search data for source file(s) of a rename operation
  8384.         (see #0933 at AH=4Eh)
  8385. 2CDh 32 BYTEs    directory entry for file being renamed (see #0668 at AH=11h)
  8386. 2EDh 331 BYTEs    critical error stack
  8387.    403h     35 BYTEs scratch SFT
  8388. 438h 384 BYTEs    disk stack (functions greater than 0Ch, INT 25,INT 26)
  8389. 5B8h 384 BYTEs    character I/O stack (functions 01h through 0Ch)
  8390. ---DOS 3.2,3.3x only---
  8391. 738h    BYTE    device driver lookahead flag (usually printer) (see AH=64h)
  8392. 739h    BYTE    volume change flag
  8393. 73Ah    BYTE    flag: virtual open
  8394. 73Bh    BYTE    ???
  8395. SeeAlso: #0990
  8396.  
  8397. Format of CLOCK$ transfer record:
  8398. Offset    Size    Description    (Table 0988)
  8399.  00h    WORD    number of days since 1-Jan-1980
  8400.  02h    BYTE    minutes
  8401.  03h    BYTE    hours
  8402.  04h    BYTE    hundredths of second
  8403.  05h    BYTE    seconds
  8404. --------D-215D07-----------------------------
  8405. INT 21 U - DOS 3.1+ network - GET REDIRECTED PRINTER MODE
  8406.     AX = 5D07h
  8407. Return: DL = mode
  8408.         00h redirected output is combined
  8409.         01h redirected output in separate print jobs
  8410. SeeAlso: AX=5D08h,AX=5D09h,INT 2F/AX=1125h
  8411. --------D-215D08-----------------------------
  8412. INT 21 U - DOS 3.1+ network - SET REDIRECTED PRINTER MODE
  8413.     AX = 5D08h
  8414.     DL = mode
  8415.         00h redirected output is combined
  8416.         01h redirected output placed in separate jobs, start new print job
  8417.         now
  8418. SeeAlso: AX=5D07h,AX=5D09h,INT 2F/AX=1125h
  8419. --------D-215D09-----------------------------
  8420. INT 21 U - DOS 3.1+ network - FLUSH REDIRECTED PRINTER OUTPUT
  8421.     AX = 5D09h
  8422. Notes:    forces redirected printer output to be printed, and starts a new print
  8423.       job
  8424.     this function is also supported by 10Net, which calls it Terminate All
  8425.       Spool Jobs, and does not flush if in "combine" mode
  8426. SeeAlso: AX=5D07h,AX=5D08h,INT 2F/AX=1125h
  8427. --------D-215D0A-----------------------------
  8428. INT 21 - DOS 3.1+ - SET EXTENDED ERROR INFORMATION
  8429.     AX = 5D0Ah
  8430.     DS:DX -> 11-word DOS parameter list (see #0986)
  8431. Return: nothing.  next call to AH=59h will return values from fields AX,BX,CX,
  8432.       DX,DI, and ES in corresponding registers
  8433. Notes:    documented for DOS 5+, but undocumented in earlier versions
  8434.     the MS-DOS Programmer's Reference incorrectly states that this call was
  8435.       introduced in DOS 4, and fails to mention that the ERROR structure
  8436.       passed to this function is a DOS parameter list.
  8437. BUGS:    DR DOS 3.41 and 5.0 read the value for ES from the DS field of the
  8438.       DPL; fortunately, MS-DOS ignores the DS field, allowing a generic
  8439.       routine which sets both DS and ES fields to the same value
  8440.     Novell DOS 7 does not save the pointer, which is always reported as
  8441.       0000h:0000h by AH=59h
  8442. SeeAlso: AH=59h/BX=0000h
  8443. --------D-215D0B-----------------------------
  8444. INT 21 OU - DOS 4.x only internal - GET DOS SWAPPABLE DATA AREAS
  8445.     AX = 5D0Bh
  8446. Return: CF set on error
  8447.         AX = error code (see #0980)
  8448.     CF clear if successful
  8449.         DS:SI -> swappable data area list (see #0989)
  8450. Notes:    copying and restoring the swappable data areas allows DOS to be
  8451.       reentered unless it is in a critical section delimited by calls to
  8452.       INT 2A/AH=80h and INT 2A/AH=81h,82h
  8453.     SHARE and other DOS utilities consult the byte at offset 04h in the
  8454.       DOS data segment (see INT 2F/AX=1203h) to determine the SDA format
  8455.       in use: 00h = DOS 3.x, 01h = DOS 4.0-6.0, other = error.
  8456.     DOS 5+ use the SDA format listed below, but revert back to the DOS 3.x
  8457.       call for finding the SDA (see #0987)
  8458. SeeAlso: AX=5D06h,INT 2A/AH=80h,INT 2A/AH=81h,INT 2A/AH=82h,INT 2F/AX=1203h
  8459.  
  8460. Format of DOS 4.x swappable data area list:
  8461. Offset    Size    Description    (Table 0989)
  8462.  00h    WORD    count of data areas
  8463.  02h  N BYTEs    "count" copies of data area record
  8464.         Offset    Size    Description
  8465.          00h    DWORD    address
  8466.          04h    WORD    length and type
  8467.                 bit 15 set if swap always, clear if swap in DOS
  8468.                 bits 14-0: length in bytes
  8469. SeeAlso: #0990
  8470.  
  8471. Format of DOS 4.0-6.0 swappable data area:
  8472. Offset    Size    Description    (Table 0990)
  8473.  -34    BYTE    printer echo flag (00h off, FFh active)
  8474.  -31    BYTE    current switch character (ignored by DOS 5+)
  8475.  -30    BYTE    current memory allocation strategy (see AH=58h)
  8476.  -28    BYTE    incremented on each INT 21/AX=5E01h call
  8477.  -27 16 BYTEs    machine name set by INT 21/AX=5E01h
  8478.  -11  5 WORDs    zero-terminated list of offsets which need to be patched to
  8479.           enable critical-section calls (see INT 2A/AH=80h)
  8480.         (all offsets are 0D0Ch, but this list is still present for
  8481.           DOS 3.x compatibility)
  8482.  -1    BYTE    unused padding
  8483. ---start of actual SDA---
  8484.  00h    BYTE    critical error flag ("ErrorMode")
  8485.  01h    BYTE    InDOS flag (count of active INT 21 calls)
  8486.  02h    BYTE    drive on which current critical error occurred or FFh
  8487.  03h    BYTE    locus of last error
  8488.  04h    WORD    extended error code of last error
  8489.  06h    BYTE    suggested action for last error
  8490.  07h    BYTE    class of last error
  8491.  08h    DWORD    ES:DI pointer for last error
  8492.  0Ch    DWORD    current DTA (Disk Transfer Address)
  8493.         note: may point into SDA during the DOS EXEC function
  8494.           (see AH=4Bh), so programs which swap the SDA must be
  8495.           prepared to move the DTA to a private buffer if they
  8496.           might be invoked during an EXEC
  8497.  10h    WORD    current PSP
  8498.  12h    WORD    stores SP across an INT 23
  8499.  14h    WORD    return code from last process termination (zerod after reading
  8500.           with AH=4Dh)
  8501.  16h    BYTE    current drive
  8502.  17h    BYTE    extended break flag
  8503.  18h    BYTE    flag: code page switching
  8504.  19h    BYTE    flag: copy of previous byte in case of INT 24 Abort
  8505. ---remainder need only be swapped if in DOS---
  8506.  1Ah    WORD    value of AX on call to INT 21
  8507.  1Ch    WORD    PSP segment for sharing/network
  8508.  1Eh    WORD    network machine number for sharing/network (0000h = us)
  8509.  20h    WORD    first usable memory block found when allocating memory
  8510.  22h    WORD    best usable memory block found when allocating memory
  8511.  24h    WORD    last usable memory block found when allocating memory
  8512.  26h    WORD    memory size in paragraphs (used only during initialization)
  8513.  28h    WORD    last entry checked during directory search
  8514.  2Ah    BYTE    flag: nonzero if INT 24 Fail
  8515.  2Bh    BYTE    flags: allowable INT 24 responses (passed to INT 24 in AH)
  8516.  2Ch    BYTE    flag: do not set directory if nonzero
  8517.  2Dh    BYTE    flag: program aborted by ^C
  8518.  2Eh    BYTE    flag: allow embedded blanks in FCB
  8519.         may also allow use of "*" wildcard in FCBs
  8520.  2Fh    BYTE    padding (unused)
  8521.  30h    BYTE    day of month
  8522.  31h    BYTE    month
  8523.  32h    WORD    year - 1980
  8524.  34h    WORD    number of days since 1-1-1980
  8525.  36h    BYTE    day of week (0 = Sunday)
  8526.  37h    BYTE    flag: console swapped during read from device
  8527.  38h    BYTE    flag: safe to call INT 28 if nonzero
  8528.  39h    BYTE    flag: abort currently in progress, turn INT 24 Abort into Fail
  8529.  3Ah 30 BYTEs    device driver request header (see #1884 at INT 2F/AX=0802h) for
  8530.           device calls
  8531.  58h    DWORD    pointer to device driver entry point (used in calling driver)
  8532.  5Ch 22 BYTEs    device driver request header for I/O calls
  8533.  72h 14 BYTEs    device driver request header for disk status check
  8534.  80h    DWORD    pointer to device I/O buffer
  8535.  84h    WORD    ???
  8536.  86h    WORD    ??? (0)
  8537.  88h    BYTE    type of PSP copy (00h=simple for INT 21/AH=26h, FFh=make child)
  8538.  89h    DWORD    start offset of file region to lock/unlock
  8539.  8Dh    DWORD    length of file region to lock/unlock
  8540.  91h    BYTE    padding (unused)
  8541.  92h  3 BYTEs    24-bit user number (see AH=30h)
  8542.  95h    BYTE    OEM number (see #0707 at AH=30h)
  8543.  96h  6 BYTEs    CLOCK$ transfer record (see #0988 at AX=5D06h)
  8544.  9Ch    BYTE    device I/O buffer for single-byte I/O functions
  8545.  9Dh    BYTE    padding???
  8546.  9Eh 128 BYTEs    buffer for filename
  8547. 11Eh 128 BYTEs    buffer for filename
  8548. 19Eh 21 BYTEs    findfirst/findnext search data block (see #0933 at AH=4Eh)
  8549. 1B3h 32 BYTEs    directory entry for found file (see #0707 at AH=11h)
  8550. 1D3h 88 BYTEs    copy of current directory structure for drive being accessed
  8551. 22Bh 11 BYTEs    FCB-format filename for device name comparison
  8552. 236h    BYTE    terminating NUL for above filename
  8553. 237h 11 BYTEs    wildcard destination specification for rename (FCB format)
  8554. 242h    BYTE    terminating NUL for above filespec
  8555. 243h    BYTE    ???
  8556. 244h    WORD    ???
  8557. 246h  5 BYTEs    ???
  8558. 24Bh    BYTE    extended FCB file attributes
  8559. 24Ch    BYTE    type of FCB (00h regular, FFh extended)
  8560. 24Dh    BYTE    directory search attributes
  8561. 24Eh    BYTE    file open/access mode
  8562. 24Fh    BYTE    ??? flag bits
  8563.         reportedly 00h when deleting a file under MSDOS 5.0
  8564. 250h    BYTE    flag: device name found on rename, or file not found
  8565. 251h    BYTE    splice flag??? (file name and directory name together)
  8566. 252h    BYTE    flag indicating how DOS function was invoked
  8567.         (00h = direct INT 20/INT 21, FFh = server call AX=5D00h)
  8568. 253h    BYTE    sector position within cluster
  8569. 254h    BYTE    ??? (flag: translate sector/cluster)
  8570. 255h    BYTE    ??? (flag: 00h if read, 01h if write)
  8571. 256h    BYTE    current working drive number
  8572. 257h    BYTE    cluster factor
  8573. 258h    BYTE    ???
  8574. 259h    BYTE    line edit (AH=0Ah) insert mode flag (nonzero = on)
  8575. 25Ah    BYTE    canonicalized filename referred to existing file/dir if FFh
  8576. 25Bh    BYTE    volume ID flag
  8577. 25Ch    BYTE    type of process termination (00h-03h) (see AH=4Dh)
  8578. 25Dh    BYTE    ???
  8579. 25Eh    BYTE    ??? file create flag (00h = no, search only)
  8580. 25Fh    BYTE    ??? (value for deleted file's first byte)
  8581. 260h    DWORD    pointer to Drive Parameter Block for critical error invocation
  8582. 264h    DWORD    pointer to stack frame containing user registers on INT 21
  8583. 268h    WORD    stores SP across INT 24
  8584. 26Ah    DWORD    pointer to DOS Drive Parameter Block for ???
  8585. 26Eh    WORD    segment of disk buffer
  8586. 270h    WORD    ??? (saving partial cluster number)
  8587. 272h    WORD    ??? (temp: sector of work current cluster)
  8588. 274h    WORD    ??? (high part of cluster number)
  8589. 276h    WORD    ??? (temp)
  8590. 278h    BYTE    Media ID byte returned by AH=1Bh,1Ch
  8591. 279h    BYTE    ??? (doesn't seem to be referenced)
  8592. 27Ah    DWORD    pointer to device header if filename is character device
  8593. 27Eh    DWORD    pointer to current SFT
  8594. 282h    DWORD    pointer to current directory structure for drive being accessed
  8595. 286h    DWORD    pointer to caller's FCB
  8596. 28Ah    WORD    SFT index to which file being opened will refer
  8597. 28Ch    WORD    temporary storage for file handle
  8598. 28Eh    DWORD    pointer to a JFT entry in process handle table
  8599.           (see #0691 at AH=26h)
  8600. 292h    WORD    offset in DOS DS of first filename argument
  8601. 294h    WORD    offset in DOS DS of second filename argument
  8602. 296h    WORD    ??? (offset of last component in pathname or FFFFh)
  8603. 298h    WORD    offset of transfer address to add
  8604. 29Ah    WORD    last relative cluster within file being accessed
  8605. 29Ch    WORD    temp: absolute cluster number being accessed
  8606. 29Eh    WORD    directory sector number
  8607. 2A0h    WORD    ???
  8608. 2A2h    WORD    ??? directory cluster number
  8609. 2A4h    DWORD    current relative sector number within file
  8610. 2A8h    DWORD    ??? (current sector number)
  8611. 2ACh    WORD    ??? (current byte offset within sector)
  8612. 2AEh    DWORD    current offset in file
  8613. 2B2h    WORD    ???
  8614. 2B4h    WORD    bytes in partial sector
  8615. 2B6h    WORD    number of sectors
  8616. 2B8h    WORD    ??? (free file cluster entry)
  8617. 2BAh    WORD    ??? (last file cluster entry)
  8618. 2BCh    WORD    ??? (next file cluster number)
  8619. 2BEh    DWORD    number of bytes appended to file
  8620. 2C2h    DWORD    pointer to current work disk buffer
  8621. 2C6h    DWORD    pointer to working SFT
  8622. 2CAh    WORD    used by INT 21 dispatcher to store caller's BX
  8623. 2CCh    WORD    used by INT 21 dispatcher to store caller's DS
  8624. 2CEh    WORD    temporary storage while saving/restoring caller's registers
  8625. 2D0h    DWORD    pointer to prev call frame (offset 264h) if INT 21 reentered
  8626.         also switched to for duration of INT 24
  8627. 2D4h    WORD    open mode/action for INT 21/AX=6C00h
  8628. 2D6h    BYTE    ??? (set to 00h by INT 21h dispatcher, 02h when a read is
  8629.           performed, and 01h or 03h by INT 21/AX=6C00h)
  8630. 2D7h    WORD    ??? apparently unused
  8631. 2D9h    DWORD    stored ES:DI for AX=6C00h
  8632. 2DDh    WORD    extended file open action code (see #1073 at AX=6C00h)
  8633. 2DFh    WORD    extended file open attributes (see #1072 at AX=6C00h)
  8634. 2E1h    WORD    extended file open file mode (see AX=6C00h)
  8635. 2E3h    DWORD    pointer to filename to open (see AX=6C00h)
  8636. 2E7h    WORD    ??? temp DX storage or 0000h or temp data buffer size from
  8637.           disk buffer
  8638. 2E9h    WORD    ???
  8639. 2EBh    BYTE    ???
  8640. 2ECh    WORD    stores DS during call to [List-of-Lists + 37h]
  8641. 2EEh    WORD    ???
  8642. 2F0h    BYTE    ???
  8643. 2F1h    WORD    ??? bit flags
  8644. 2F3h    DWORD    pointer to user-supplied filename
  8645. 2F7h    DWORD    pointer to ???
  8646. 2FBh    WORD    stores SS during call to [List-of-Lists + 37h]
  8647. 2FDh    WORD    stores SP during call to [List-of-Lists + 37h]
  8648. 2FFh    BYTE    flag, nonzero if stack switched in calling [List-of-Lists+37h]
  8649. 300h 21 BYTEs    FindFirst search data for source file(s) of a rename operation
  8650.         (see #0933 at AH=4Eh)
  8651. 315h 32 BYTEs    directory entry for file being renamed (see #0668 at AH=11h)
  8652. 335h 331 BYTEs    critical error stack
  8653. 480h 384 BYTEs    disk stack (functions greater than 0Ch, INT 25,INT 26)
  8654. 600h 384 BYTEs    character I/O stack (functions 01h through 0Ch)
  8655. 780h    BYTE    device driver lookahead flag (usually printer) (see AH=64h)
  8656. 781h    BYTE    volume change flag
  8657. 782h    BYTE    flag: virtual open
  8658. 783h    BYTE    ???
  8659. 784h    WORD    ???
  8660. 786h    WORD    ???
  8661. 788h    WORD    ???
  8662. 78Ah    WORD    ???
  8663. SeeAlso: #0987,#0989
  8664. --------D-215E00-----------------------------
  8665. INT 21 - DOS 3.1+ network - GET MACHINE NAME
  8666.     AX = 5E00h
  8667.     DS:DX -> 16-byte buffer for ASCII machine name
  8668. Return: CF clear if successful
  8669.         CH = validity
  8670.         00h name invalid
  8671.         nonzero valid
  8672.             CL = NetBIOS number for machine name
  8673.             DS:DX buffer filled with blank-paded name
  8674.     CF set on error
  8675.         AX = error code (01h) (see #0980 at AH=59h)
  8676. Note:    supported by OS/2 v1.3+ compatibility box, PC-NFS
  8677. SeeAlso: AX=5E01h
  8678. --------N-215E00-----------------------------
  8679. INT 21 - 10NET v5.0 - GET MACHINE NAME
  8680.     AX = 5E00h
  8681. Return: CL = redirector's NetBIOS name number
  8682.     ES:DI -> network node ID
  8683. SeeAlso: AX=5E01h"10NET"
  8684. --------D-215E01CH00-------------------------
  8685. INT 21 - DOS 3.1+ network - SET MACHINE NAME
  8686.     AX = 5E01h
  8687.     CH = 00h undefine name (make it invalid)
  8688.        <> 0     define name
  8689.     CL = name number
  8690.     DS:DX -> 15-character blank-padded ASCIZ name
  8691. SeeAlso: AX=5E00h
  8692. --------N-215E01-----------------------------
  8693. INT 21 - 10NET v5.0 - GET LOCAL 10NET CONFIGURATION TABLE
  8694.     AX = 5E01h
  8695.     CX = length of buffer
  8696.     DS:DX -> buffer for 10Net configuration table (see #821)
  8697. SeeAlso: AX=5E00h"10NET",INT 6F/AH=02h,INT 6F/AH=03h
  8698.  
  8699. Format of 10Net Configuration Table:
  8700. Offset    Size    Description    (Table 0991)
  8701.  00h  8 BYTEs    user name
  8702.  08h 15 BYTEs    node ID
  8703.  17h  3 BYTEs    unique portion of Ethernet address
  8704.  1Ah    BYTE    Who group number
  8705.  1Bh    WORD    services mask (see #0993)
  8706.  1Dh    DWORD    serial number
  8707.  21h    BYTE    maximum concurrent users with same serial number allowed on net
  8708.  22h    BYTE    chat mask (see #0994)
  8709.  23h    BYTE    internal system bits (see #0995)
  8710.  24h  9 BYTEs    version number in format MM.mm.xxx
  8711.  2Dh    BYTE    flag: 01h if machine is a PS/2
  8712.  2Eh    BYTE    flag: 03h if 80386
  8713.  2Fh    BYTE    spool termination mode: 01h concatenate, 02h truncate
  8714.         (see AX=5D09h)
  8715.  30h    WORD    autospool timeout in clock ticks
  8716.  32h    WORD    monitor timeout in clock ticks
  8717.  34h    WORD    unused
  8718.  36h    WORD    chat timeout in clock ticks
  8719.  38h    WORD    netBIOS session timeout in half-seconds
  8720.  3Ah    WORD    datagram send timeout in seconds
  8721.  3Ch    WORD    keyboard value for initiating chat mode
  8722.  3Eh    WORD    Who timeout in clock ticks
  8723.  40h    BYTE    flag: 01h if server should process rom NetBIOS Post return
  8724.  41h    BYTE    flag: 01h if FCBs should be recycled
  8725.  42h  3 BYTEs    signature "DBG"
  8726.  45h    BYTE    last interrupt (21h or 6Fh)
  8727.  46h    BYTE    last INT 21 AH value
  8728.  47h    BYTE    last INT 6F AH value
  8729.  48h    WORD    last item posted
  8730.  4Ah    WORD    last item free-posted
  8731.  4Ch    WORD    last item handled by server
  8732.  4Eh    WORD    last redirector send NCB
  8733.  50h    WORD    last redirector receive NCB
  8734.  52h  4 BYTEs    signature "TABL"
  8735.  56h    WORD    offset of datagram buffer table header (see #0992)
  8736.  58h    WORD    offset of chat buffer table header (see #0992)
  8737.  5Ah    WORD    offset of Raw buffer table header (see #0992)
  8738.  5Ch    WORD    offset of Workstation buffer table header (see #0992)
  8739.  5Eh    WORD    offset of server receive-any table header (see #0992)
  8740.  60h    WORD    offset of Tiny buffer table header (see #0992)
  8741.  62h    WORD    offset of zero-length buffer table (NCBs) (see #0992)
  8742.  64h    WORD    offset of Rdr (Redirector Mount) table header (see #0992)
  8743.  66h    WORD    offset of Ntab (Redirector Session) table header (see #0992)
  8744.  68h    WORD    offset of FCB table header (see #0992)
  8745.  6Ah    WORD    offset of user file handle table header (see #0992)
  8746.  6Ch    WORD    offset of workstation printer RDR extension table header
  8747.  6Eh    WORD    offset of server shared device table header (see #0992)
  8748.  70h    WORD    offset of server connection table header (see #0992)
  8749.  72h    WORD    offset of server login table header (see #0992)
  8750.  74h    WORD    offset of server file table header (see #0992)
  8751.  76h    WORD    offset of server shared file table header (see #0992)
  8752.  78h    WORD    offset of server record lock table header (see #0992)
  8753.  7Ah    WORD    offset of remote printer claim table header (see #0992)
  8754.  7Ch    WORD    offset of remote printer device table header (see #0992)
  8755.  7Eh    WORD    offset of print server mount table header (see #0992)
  8756.  80h    WORD    offset of print server sessions table header (see #0992)
  8757.  82h    WORD    offset of print server print job structure table header
  8758.  84h    WORD    offset of print server pooled device table header (see #0992)
  8759.  86h    WORD    size of workstation buffer
  8760.  88h    WORD    size of server receive-any buffer
  8761.  8Ah    WORD    size of server raw I/O buffer
  8762.  8Ch  6 BYTEs    reserved
  8763.  92h    DWORD    pointer to profile pathname
  8764.  96h    BYTE    datagram retry count
  8765.  97h    BYTE    NetBIOS LAN adapter number
  8766.  98h  6 BYTEs    physical Ethernet address
  8767.  9Eh    BYTE    NetBIOS server name number
  8768.  9Fh    BYTE    NetBIOS redirector name number
  8769.  A0h    BYTE    10Net interrupt number
  8770.  A1h    BYTE    flag: chat is loaded
  8771.  A2h    BYTE    flag: INT 6F APIs permanently loaded
  8772.  A3h    BYTE    flag: file security present
  8773.  A4h    WORD    reserved
  8774.  A6h    BYTE    fixed mount bitmask for drives A:-H:
  8775.  A7h    BYTE    reserved
  8776.  A8h    WORD    10Net system flags (see #0996)
  8777.  AAh    BYTE    monitor flags (see #0997)
  8778.  ABh  5 BYTEs    reserved
  8779.  B0h    WORD    offset of monitor timer block
  8780.  B2h    WORD    offset of server timer block
  8781.  B4h    WORD    offset of chat timer block
  8782.  B6h    WORD    timer chain
  8783.  B8h  4 BYTEs    signature "TALS"
  8784.  BCh    WORD    number of 10Net sends
  8785.  BEh    WORD    number of 10Net receives
  8786.  C0h    WORD    number of no-buffer conditions
  8787.  C2h    WORD    number of dropped posted messages
  8788.  C4h    WORD    number of server NCB errors
  8789.  C6h    WORD    number of redirector NCB errors
  8790.  C8h    WORD    number of datagram send/receive errors
  8791.  CAh    WORD    number of dropped Whos
  8792.  CCh    WORD    number of dropped submits
  8793.  CEh    WORD    number of session aborts
  8794.  D0h    BYTE    number of NetBIOS interface-busy errors
  8795.  D1h    BYTE    last NetBIOS bad post command
  8796.  D2h    BYTE    last NetBIOS bad redirector command
  8797.  D3h    BYTE    do send datagram send/receive error command
  8798.  D4h    DWORD    -> DOS system parameter table
  8799.  D8h    WORD    number of DOS physical drives
  8800.  DAh    WORD    offset of DOS PSP field in DOS data segment
  8801.  DCh    WORD    offset of in-DOS flag in DOS data segment
  8802.  DEh    WORD    DOS data segment
  8803.  E0h    WORD    offset of DOS SFT in DOS data segment
  8804.  E2h    WORD    offset of number-of-physical-units field in DOS data segment
  8805.  E4h    WORD    10Net code segment
  8806.  E6h    WORD    10Net data segment
  8807.  E8h    WORD    10Net common server segment
  8808.  EAh    WORD    10Net file server segment
  8809.  ECh    WORD    10Net print server segment
  8810.  EEh    WORD    10Net remote printer segment
  8811. Note:    documentation lists field at offset D0h as a WORD, but all following
  8812.       offsets are as though it were a BYTE; if it is indeed a WORD, all
  8813.       offsets after D0h must be increased by one byte
  8814.  
  8815. Format of 10Net Table Header:
  8816. Offset    Size    Description    (Table 0992)
  8817.  -16  4 BYTEs    table identifier
  8818.  -12    WORD    peak number of tables allocated
  8819.  -10    WORD    number of tables currently in use
  8820.  -8    WORD    total number of tables
  8821.  -6    WORD    size of each table
  8822.  -4    WORD    offset of first allocated table
  8823.  -2    WORD    offset of first free table
  8824.  
  8825. Bitfields for 10NET services mask:
  8826. Bit(s)    Description    (Table 0993)
  8827.  0    workstation
  8828.  1    file server
  8829.  2    print queue server
  8830.  3    de-spool server
  8831.  
  8832. Bitfields for 10NET chat mask:
  8833. Bit(s)    Description    (Table 0994)
  8834.  0    chat permitted
  8835.  1    bell enabled
  8836.  2    chat keyboard initiated
  8837.  3    in INT 16 handler
  8838.  4    in Get Input
  8839.  5    display has timed out
  8840.  6    chat is idle
  8841.  
  8842. Bitfields for 10NET internal system bits:
  8843. Bit(s)    Description    (Table 0995)
  8844.  0    submit permitted
  8845.  1    submit initiated
  8846.  2    submit executing
  8847.  3    internal client call/chat/spool/autospool
  8848.  4    in spool termination
  8849.  5    print permitted
  8850.  6    waiting for keyboard input
  8851.  
  8852. Bitfields for 10NET System Flags:
  8853. Bit(s)    Description    (Table 0996)
  8854.  0    in NetBIOS
  8855.  1    processing INT 28
  8856.  2    is server
  8857.  3    in net user-DOS function
  8858.  4    in DOS user-DOS function
  8859.  5    in net for user non-DOS function
  8860.  6    in server DOS function
  8861.  7    in server non-DOS function
  8862.  8    in terminate
  8863.  10    in user on server request
  8864.  13    in DOS for user on server
  8865.  14    disable critical error handler
  8866.  
  8867. Bitfields for Monitor Flags:
  8868. Bit(s)    Description    (Table 0997)
  8869.  0    waiting for monitor response
  8870.  4    in monitor get-input routine
  8871.  5    monitor display timeout
  8872.  6    sensing for escape key
  8873. --------D-215E02-----------------------------
  8874. INT 21 - DOS 3.1+ network - SET NETWORK PRINTER SETUP STRING
  8875.     AX = 5E02h
  8876.     BX = redirection list index (see AX=5F02h)
  8877.     CX = length of setup string
  8878.     DS:SI -> setup string
  8879. Return: CF clear if successful
  8880.     CF set on error
  8881.         AX = error code (01h) (see #0980 at AH=59h)
  8882. Note:    also supported by 10NET v5.0
  8883. SeeAlso: AX=5E03h,INT 2F/AX=111Fh
  8884. --------D-215E03-----------------------------
  8885. INT 21 - DOS 3.1+ network - GET NETWORK PRINTER SETUP STRING
  8886.     AX = 5E03h
  8887.     BX = redirection list index (see AX=5F02h)
  8888.     ES:DI -> 64-byte buffer for setup string
  8889. Return: CF clear if successful
  8890.         CX = length of setup string
  8891.         ES:DI buffer filled
  8892.     CF set on error
  8893.         AX = error code (01h) (see #0980 at AH=59h)
  8894. Note:    also supported by 10NET v5.0, but 10NET is documented as using DS:SI
  8895.       instead of ES:DI
  8896. SeeAlso: AX=5E02h,INT 2F/AX=111Fh
  8897. --------D-215E04-----------------------------
  8898. INT 21 - DOS 3.1+ network - SET PRINTER MODE
  8899.     AX = 5E04h
  8900.     BX = redirection list index (see AX=5F02h)
  8901.     DX = mode
  8902.         bit 0: set if binary, clear if text (tabs expanded to blanks)
  8903. Return: CF set on error
  8904.         AX = error code (see #0980 at AH=59h)
  8905.     CF clear if successful
  8906. Note:    calls INT 2F/AX=111Fh with 5E04h on stack
  8907. SeeAlso: AX=5E05h"DOS",INT 2F/AX=111Fh
  8908. --------N-215E04-----------------------------
  8909. INT 21 - 10NET v5.0 - INITIATE PRINT JOB
  8910.     AX = 5E04h
  8911.     BX = zero-based redirection list index (see AX=5F02h)
  8912.     DS:DX -> extended workstation printer setup structure (see #0998)
  8913. Return: CF clear if successful
  8914.     CF set on error
  8915.         AX = error code (see #0980 at AH=59h)
  8916. SeeAlso: AX=5E05h"10NET",AX=5E06h"10NET"
  8917.  
  8918. Format of 10NET extended workstation printer setup structure:
  8919. Offset    Size    Description    (Table 0998)
  8920.  00h    BYTE    notification flags (see #0999)
  8921.  01h    BYTE    job control mask (see #1000)
  8922.  02h    WORD    days to retain file
  8923.  04h    WORD    test print length
  8924.  06h    BYTE    number of copies to print
  8925.  07h    BYTE    compression algorithm
  8926.  08h    BYTE    tab width (00h = don't expand)
  8927.  09h    BYTE    initiation type (00h normal, 01h non-spooled)
  8928.  0Ah 38 BYTEs    job start operation notification instructions
  8929.  30h 32 BYTEs    comment for job
  8930.  50h 64 BYTEs    output filename or non-spooled file
  8931.  
  8932. Bitfields for 10NET notification flags:
  8933. Bit(s)    Description    (Table 0999)
  8934.  0    user at print start
  8935.  1    operator at start, with reply
  8936.  2    user at print completion
  8937.  3    operator at completion, with reply
  8938.  4    user on queue switch
  8939.  5    operator on queue switch, with reply
  8940.  6    user on print error
  8941.  
  8942. Bitfields for 10NET job control mask:
  8943. Bit(s)    Description    (Table 1000)
  8944.  0    print banner page
  8945.  1    eject page at end of job
  8946.  2    mark as "held" (queue but don't print)
  8947.  3    rush job (queue at top)
  8948.  4    overwrite file with zeros before deletion
  8949.  5    hyperspool if possible
  8950. --------D-215E05-----------------------------
  8951. INT 21 - DOS 3.1+ network - GET PRINTER MODE
  8952.     AX = 5E05h
  8953.     BX = redirection list index (see AX=5F02h)
  8954. Return: CF set on error
  8955.         AX = error code (see #0980 at AH=59h)
  8956.     CF clear if successful
  8957.         DX = printer mode (see AX=5E04h)
  8958. Note:    calls INT 2F/AX=111Fh with 5E05h on stack
  8959. SeeAlso: AX=5E04h"DOS",INT 2F/AX=111Fh
  8960. --------N-215E05-----------------------------
  8961. INT 21 - 10NET v5.0 - TERMINATE PRINT JOB
  8962.     AX = 5E05h
  8963.     BX = zero-based redirection list index (see AX=5F02h)
  8964. Return: CF clear if successful
  8965.     CF set on error
  8966.         AX = error code (see #0980 at AH=59h)
  8967. Note:    this call resets the spool termination mode to "truncate"
  8968.       (see AX=5D08h)
  8969. SeeAlso: AX=5E04h"10NET",AX=5E06h
  8970. --------N-215E06-----------------------------
  8971. INT 21 - 10NET v5.0 - GET/SET 10NET WORKSTATION PRINTER SETUP STRUCTURE
  8972.     AX = 5E06h
  8973.     BX = zero-based redirection list index (see AX=5F02h)
  8974.     CX = operation (06h set, 07h get)
  8975.     DS:DX -> buffer for setup structure (same as first nine bytes of
  8976.           workstation printer setup) (see #0998)
  8977. Return: CF clear if successful
  8978.         DS:DX buffer updated on get
  8979.     CF set on error
  8980.         AX = error code (see #0980 at AH=59h)
  8981. SeeAlso: AX=5E04h"10NET",AX=5E05h"10NET"
  8982. --------!---Section--------------------------
  8983.